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PREFACE 



This manual describes QUERY/3000, the Hewlett-Packard Data Base Inquiry Facility which 
is designed to run under the control of the HP 3000 Multiprogramming Executive (MPE) 
Operating System. QUERY/3000 enables you to access data in an IMAGE/3000 data base 
without writing a computer program. 

In order to use QUERY you should know enough about the MPE Operating System to start 
a job or operate in session mode. It is recommended that you read the first section of Using 
the HP 3000 if you are not an experienced MPE user. Knowledge of EDIT/3000 and simple 
MPE file commands is useful for some of the advanced QUERY techniques but is not required 
to operate QUERY. 

You may need to consult the following manuals when using QUERY: 

• HP 3000 Computer System IMAGE Reference Manual (32215-90003) gives complete 
information about the IMAGE/3000 Data Base Management System. (In the text this manual 
is abbreviated as IMAGE/3000 Reference Manual. ) 

• Using the HP 3000 (03000-90121) provides a brief introduction to the MPE Operating 
System. 

• MPE Commands Reference Manual (30000-90009) contains a complete 
description of the MPE/ 3000 Operating System commands. 

• SORT/3000 Reference Manual (32214-90001) describes the SORT/3000 procedures. 

• DS/3000 Reference Manual (32190-90001) contains a complete description of the Distributed 
Systems software. 

This manual is arranged in six sections and three appendices. Section I introduces IMAGE/ 
QUERY terminology, briefly describes an IMAGE data base, and discusses other important 
general IMAGE, QUERY, and MPE concepts. In Section II instructions are given for oper- 
ating QUERY/3000 in session or job mode and the QUERY commands which specify the 
environment and assist you in using QUERY are described. The QUERY commands in the 
next three sections are organized by function. Section III describes commands which locate 
data and add, delete, or change data in the data base. Section IV discusses the various commands 
which report on data and Section V describes commands available for creating, altering, and 
displaying other QUERY commands saved in a file as procedures. All error messages are des- 
cribed in Section VI and Appendix C. Appendix A contains a command summary or quick 
reference table and Appendix B lists all ASCII characters. Methods of accessing a remote data base 
are described in Appendix D. 



If your 3000 operating system is MPE-C, the following differences should be noted : 

• The IMAGE Reference Manual (30000-90041 ) should be used. 

• Whenever the MPE Commands Reference Manual is referenced in this manual, use the 
MPE/3000 Operating System Reference Manual (03000-90005). 

• All references to R4 extended precision numbers should be translated to R3. The number 
of significant digits in an R 3 number is 11 to 12 and the largest accurate absolute integer 
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PREFACE (continued) 



is 549,755,813,887. QUERY rounds to 11 digits when printing R3 values. The minimum 
and maximum values for R3 numbers can be computed by rounding the R4 values in 
Table 1-1 to 11 significant digits. 



• It is not possible to access a remote data base. 



CONVENTIONS USED IN THIS MANUAL 



NOTATION 

[ ] 



{} 



DESCRIPTION 

An element inside brackets is optional. Several elements stacked inside a pair of brackets means 
the user may select any one or none of these elements. 



Example: 



user may select A or B or neither 



When several elements are stacked within braces the user must select one of these elements. 



Example: { B > user must select A or B or C. 

|cj 

italics Lowercase italics denote a parameter which must be replaced by a user-supplied variable. 

Example: CALL name 

name one to 15 alphanumeric characters. 

underlining Dialogue: Where it is necessary to distinguish user input from computer output, the input is 

underlined. 

Example: NEW NAME? ALPHAl 
superscript C Control characters are indicated by a superscript C 
Example: Y*^ 

return return in italics indicates a carriage return 

linefeed linefeed in italics indicates a linefeed 

... A horizontal ellipsis indicates that a previous bracketed element may be repeated, or that elements 

have been omitted. 



vi 
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ix 



INTRODUCING QUERY/3000 



SECTION 



QUERY/3000 provides a simple method of accessing an IMAGE/3000 data base without 
programming effort. You may use QUERY to do the following: 



• enter data 

• modify or delete data values on-line 

• retrieve data which meets selection criteria 

• report on the data retrieved. 

You perform these operations by entering simple commands consisting of English-language 
key words such as FIND and REPORT. 

You only need to know the relationships of the data base elements and not the structure of 
the disc files; QUERY finds the data and performs the operations in response to your com- 
mands using the data set and data item names you specify. 



QUERY can be used from either a terminal or a batch input device such as a card reader. If 
you are in MPE session mode at a terminal, QUERY operates interactively, prompting you 
for commands, issuing error messages when an error occurs, and printing other information 
of interest to you. You can operate QUERY in batch mode as an MPE job from a batch 
input device. If a file system or IMAGE error occurs, QUERY prints an error message; in 
some cases, such as file read or write errors, QUERY terminates the job. 



A sequence of commands can be stored in a file and executed at any time by entering a single 
command, XEQ, as part of a session or a job. A frequently used or complex command can be 
stored as an individual procedure in a command file (known as the Proc-file). The procedure 
name can then be used in place of the command parameters. 



You may request information about the data base structure with the FORM command and 
information about QUERY commands, their function, format, and parameters with the HELP 
command. 



QUERY adheres to all of the IMAGE/3000 security provisions described in the IMAGE/3000 
Reference Manual. You must enter one of the valid passwords for the data base you are using. 
This word determines which information you may access in the data base. 



query's report formatting capability enables you to build reports with header and column 
labels, page numbers, and group labels. In addition, you can sort entries through multiple 
fields, as well as total, average, or count columns of numeric data values. QUERY also pro- 
vides 10 registers for doing computations for reports. 
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If your local HP 3000 and a remote HP 3000 have Distributed Systems (DS/3000) capa- 
bility, you can use QUERY to access a data base residing on the remote computer and 
retrieve information to be used on the local system. Three methods for accessing a remote 
data base are described in Appendix D. 

All of the tasks described above can be accomplished without programming. If you are 
developing programs which access IMAGE data bases through the IMAGE library procedures, 
QUERY makes an excellent debugging aid. You can alter the data base content using your 
program and then use QUERY to examine the data and determine the results of your pro- 
grammed changes. 



PASSWORDS 

Before you can access the data base, QUERY must know your password. Passwords are de- 
fined by the data base designer or administrator and control read and write access to infor- 
mation in the data base. You must ask the data base administrator for a password and enter 
the word as described later in this section. 

It is possible to gain access to some data without a password if the data base is designed to 
allow such access. 



STRUCTURE OF THE DATA BASE 

It is not necessary to understand all the IMAGE features in order to use QUERY. However, 
it is important to have a general idea of the data base structure and to know the definitions 
of some IMAGE terms. You must use these terms in the QUERY commands described in 
the following sections. For those readers who are not familiar with IMAGE, here is an over- 
view of the data base structure. 

Each item of information in a data base is referenced by a data item name. The name asso- 
ciates the information with characteristics which describe it: 

• the type of information (numeric or alphanumeric) 

• its relation to other data in the data base 

• the passwords required to read or write the information. 

The data base designer organizes data items into data sets for the purpose of accessing them 
as a group. For example, an employee data set could contain the items EMPID, F-NAME, 
L-NAME, SOCSEC#, and SALARY. A credit union data set could contain EMPID, 
AMOUNT, TRANSCODE, and so forth. Each data set is referenced by a data set name. 
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Each time you enter a new employee's record into the data base, you can supply a value for 
each data item. For example. 



F-NAME 



SALLY 



L-NAME 



MERTON 



SOCSEC# 



527-58-6492 



SALARY 



18000.02 



This group of values is stored as a single data entry in the data set. 

QUERY allows you to locate particular entries which have values you specify. You can then 
change the values or print them in a report. You can also add or delete an entire entry if 
your password gives you the capability to write each data item in the data set. 

You can use a QUERY command, FORM, to display the names of each data set to which 
you have access and the names of the data items in these sets. Only the items to which you 
have at least read access are listed. 



FULLY-QUALIFIED DATA ITEM NAMES 

IMAGE allows the data base designer to use the same name for two or more items provided 
the items are not part of the same data set. If you are referring to such an item, you must 
specify which data set to access. You can do this in one of three ways: 

• through the DATA-SETS=command described in Section II, 

• through the DEFINE command DATA-SETS=prompt, which is also defined in Section 



• by qualifying the data item name. 

A fully-qualified data item name is a data set name followed by a period, followed by a data 
item name. For example. 



BADGE# is the name of a data item in the data set named LABOR. 

If BADGE# is also the name of a data item in a data set named EMPLOYEE, its fully-qualified 
name will be EMPLOYEE.BADGE#. 

The discussion of data set lists in Section II explains more completely the way QUERY deter- 
mines which data set to use. 



II, 



LABOR.BADGE# 
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DATA TYPES 



The data base designer defines each data item as a particular type depending on what kind of 
information is to be stored in the item. It may be one of several types of integers, real or 
floating-point numbers, or ASCII character information. (Appendix B contains the ASCII 
character set.) 

The FORM command also displays the data type for each item. When using QUERY, you 
will usually be unconcerned about the specific data type with these exceptions: 

• when supplying values for an item, either to enter new information or to locate specific 
entries, you may want to know the acceptable range of values for a numeric type item 

• when creating reports you should be aware of the item types in order to format the 
report properly 

• when using the QUERY registers while printing a report, it is helpful to know how cal- 
culations affect the register values. 

Detailed information about each of these situations is given with the appropriate com- 
mand in the sections which follow. Table 1-1 contains a summary of the data types and the 
range of acceptable values for each type. 



If you use QUERY to enter a value for a data item of type P (packed decimal), you should 
be aware of the way QUERY handles the sign of the value. A different code is used for the 
sign of a value entered with a plus sign than for a value entered without a sign. However, 
when QUERY retrieves unsigned and positive type P data items with the same vdue, they 
are considered to be equivalent. For example, +2 and 2 are equivalent. Data items with values 
+0 and 0 are sdso equivalent but a data item with a value of -0 is less than a data item with 
a value of +0 or 0. When using a data item value as a key, IMAGE differentiates between 
positive, unsigned, and negative data items with the ssime value. 



DATA VALUES 

When specifying the value of a particular data item, you must sometimes surround the 
value with quote marks. This type of value is called a literal. A character or string literal 
contains alphanumeric characters. For example, 

"TANYA OAKLEY:: "ZXR-93458273" "3215" 

Character literals containing numeric values of the types listed under INTEGER or REAL in 
Table 1-1 are called, more specifically, numeric literals. For example, 

"5468" "-H408E-15" "-16.73892" 

The rules for using quote marks are described with the specific commands which allow or 
require their use. 
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Table 1-1. Data Item Types 



TYPE 


MINIMUM 


MAXIMUM 


1 nteger 






11 


-32768 


+32767 


12 


-2,147,483,648 


+2,147,483,647 


J1 


-9999 


+9999 


J2 


-999999999 


+999999999 


K1 


0 


+65535 


Tjn 


- {n digit number) 


+ (n digit number) 


Pn (n must be even) 


~ (n - ^ digit number) 


+ {n - digit number) 


Note: n cannot exceed 255 and must be even for type Pn. 
for type Z and 19 digits for type P data values. 


QUERY reports prmt at most 20 digits 


Real 






R2 


-1.157921 X 10^'' 


-0.863617 X lO"''^ 




+0.863617 X 10"^^ 


+1.157921 X 10^'' 




The largest accurate absolute integer is 8,388,607. 
(QUERY rounds to 6 digits when printing R2 values.) 


R4 


- 1.157920892373162 X 10^^ 


-0.8636168555094445 x 10"^^ 




+0.8636168555094445 X 10 +1.157920892373162 x 10^^ 




The largest accurate absolute integer is 36,028,797,018,963,967 
(QUERY rounds to 16 digits when printing R4 values.) 


Character 






Un 


1 ASCII character 
(lower case not allowed) 


n ASCII characters 
(lower case not allowed) 


Xn 


1 ASCI 1 character 


n ASCII characters 


Note: n cannot exceed 255. QUERY reports print at most 136 characters for type U and X data 
values. 



1-5 



COMPOUND DATA ITEMS 



IMAGE allows the data base designer to specify compound data items. These items occur 
more than once within the same data entry. Each occurrence of the data item is called a 
sub-item and each sub-item may have a value. QUERY locates and processes only the first 
sub-item with the FIND, UPDATE, LIST, and REPORT commands. REPORT ALL is an 
exception; it prints the values for all sub-items. 

Even though QUERY updates only the first sub-item, it does preserve the existing values 
of all other sub-items. 

DATA SET RELATIONS 

There are three types of IMAGE data sets: manual master, automatic master, and detail. 
Master data sets are related to detail data sets through specific items called search (or key) 
items. The FORM command identifies the data set type and search items. You can carry 
out QUERY operations without reference to data set types or search items except when 
using the FIND CHAIN and UPDATE commands. 

The data base designer can specify one or more sort items. These items are also identified 
by the FORM command. As a QUERY user, you need not understand the function of 
sort items, but you should be aware of which items are sort items when using the UPDATE 
command. 

If you want to know more about data set relations and sort items, read the IMAGE/3000 
Reference Manual description of the data base structure. 

SAMPLE DATA BASE 

Figure 1-1 and 1-2 illustrate a sample data base named STORE. The STORE data base is 
used in many examples in this manual. It contains six data sets (4 masters and 2 details): 

• CUSTOMER contains information about each of the store's customers 

• DATE-MASTER is an index of dates. It can be used to retrieve information by date 
from the SALES or INVENTORY data sets. 

• PRODUCT contains information about each product in the store 

• SALES has credit and purchase information 

• SUP-MASTER contains information about each of the store's suppliers 

• INVENTORY has product supply information 

Both figures show a single entry for each data set. Figure 1-1 contains the data item names 
and figure 1-2 contains a sample of the values in one entry. The arrows in both figures 
illustrate the relationship of the data sets through search items. The four master data sets 
are shown in the center column and the details on the sides. 

The data base is not meant to be a practical application but rather is designed to illustrate 
as many IMAGE/QUERY features as possible. It does illustrate some important design 
considerations. For a complete discussion of these see the IMAGE/3000 Reference Manual. 
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MASTER SETS 



CUSTOMER 

, ACCOUNT (J2) 
LAST-NAME (X16) 
FIRST-NAME (X10) 
INITIAL (U2) 
STREET-ADDRESS (X26) 
CITY (X12) 
STATE (X2) 
ZIP (X6) 

CREDIT-RATING (R2) 



DETAIL SET 



SUP-MASTER 



SUPPLIER (X16) 

STREET-ADDRESS (X26) ' 
CITY (X12) 
STATE (X2) 
ZIP (X6) 



DETAIL SET 



SALES 

ACCOUNT (J2) 
STOCK* (U8) — 
QUANTITY (I) 
PRICE (J2) 
TAX (J2) 
TOTAL (J2) 
PURCH-DATE (X6) 
DELIV-DATE (X6) 



PRODUCT 



STOCK* (U8) 

DESCRIPTION (X20) 

DATE-MASTER 

DATE (X6) 



INVENTORY 

■STOCK* (U8) 
ON HAN DOTY (J2) 

' SUPPLIER (X16) 
UNIT-COST (P8) 
LASTSHIPDATE (X6) 
BINNUM (Z2) 



Figure 1-1. Data Base Structure 



MASTER SETS 



CUSTOMER 




Note: DATE-MASTER contains 
two entries in this example. 
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Figure 1-2. Sample Entry Values 
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Table 1-2. Command Categories 



CATEGORY 


COMMANDS 


FUNCTION SECTION 


Environment 


DATA-BASE= 


Specifies the data base to be accessed II 




DATA-SETS= 


Specifies the data sets to be accessed. 




PROC-FILE= 


Specifies which Proc-file to be used. 




OUTPUT= 


Specifies the output device to be used for com- 
mand output. 




DEFINE 


Indicates the current state of the Environment 
commands and prompts you for changes. 




PASSWORD= 


Specifies access password. 




MODE= 


Specifies access mode. 


Utility 


FORM 


Displays the structure of the data base being II 
accessed. 




HELP 


Lists a description of the QUERY command set. 




EXIT 


Terminates QUERY execution. 




VERSION 


Displays version, update, and fix information. 


Location 


FIND 


Locates data entries in the data base according III 
to your specifications. 


Updating 


ADD or 
UPDATE ADD 


Adds data entries to the data base. 




DELETE or 
UPDATE DELETE 


Removes data entries from the data base. 




REPLACE or 
UPDATE REPLACE 


Modifies data items in data entries. 


Reporting 


REPORT 


Reports about the entries located by the FIND IV 
command. 




LIST 


Prints entries with automatic formatting. 


Procedure 


CREATE 


Stores procedures in the Proc-file, V 




DlbrLAY 


Displays procedures stored in the Proc-file. 




ALTER 


Modifies procedures currently stored in the 
Proc-file. 




DESTROY 


Removes procedures from the Proc-file. 




RENAME 


Changes procedure name. 


Operation 


XEQ 


Executes QUERY commands from a file. 
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COMMANDS 



QUERY commands are divided into seven categories according to their function. Table 1-2 
describes the categories and the commands within each category. Detailed descriptions of 
each command are given in Sections II through V, however, you should understand the fol- 
lowing characteristics which apply to all commands: 

• Command names may be spelled out completely or abbreviated. The abbreviation for 
each command is specified with the format description. You must be careful to use the 
correct abbreviation. 

• Commands consist of English keywords and parameters (both required and optional), 
all separated by one or more blanks. 

• QUERY processes only the first 72 characters of a line (record). Any remaining char- 
acters can be used for comments or sequencing information. 

• If the command you want to enter is longer than 72 characters, you may continue it 
on the next line by using an ampersand (&) as the last character on the current line. 
QUERY combines all lines connected with the & continuation character. Any blanks 
preceding the & are saved. Therefore, if you break a command name or other param- 
eter with an &, the & should be adjacent to the last significant character with no 
intervening blanks. 

Ampersands are not required to continue when entering the CREATE command in multiple 
lines (records). 



Each person using QUERY to access a data base must specify one of the available modes of 
access numbered from 1 to 8. Assuming that the MPE security provisions and your data base 
password permit it, you can do the following: 



MODES OF ACCESS 



If your mode is 1 



you may: 



find (read), replace, add, delete entries 
(QUERY requests IMAGE dynamically 
lock and unlock the data base when 
accessing it). 

find and replace entries. 

find, replace, add, and delete entries. 



2 



3* or 4 



5 



find entries. (QUERY locks and unlocks), 
find entries. 



6, 7*, or 8 



*Modes 3 and 7 give you exclusive access to the data base. All other modes allow others to 
share the data base. Search and sort items cannot be replaced. 



A data base can only be shared in certain well-defined environments. The mode you specify 
must be acceptable for the environment already established by other IMAGE and QUERY 
users (if any) when you open the data base. Here is a summary of the acceptable environments: 

• multiple mode 1 and mode 5 users 

• multiple mode 6 and mode 2 users 

• multiple mode 6 users and one mode 4 user 

• multiple mode 6 and mode 8 users 

• one mode 3 user 

• one mode 7 user. 

Subsets of these environments are also allowed. For example, there may be all mode 6 users 
or all mode 8 users. There may also be one mode 1 user or all mode 5 users and so forth. 

If a mode 3 (or mode 7) user is currently accessing the data base that you want to access, 
you must wait until that user either terminates his or her IMAGE or QUERY session or 
accesses a different data base. This is true anytime you try to access a data base with a 
mode which is incompatible with other users accessing the same data base, unless you 
change your own mode of access. 

Figure 1-3 illustrates the acceptable IMAGE/QUERY environments. Users who are smiling 
are allowed to operate IMAGE or QUERY simultaneously. The others must wait until only 
users with compatible modes are operating. Capability is abbreviated as follows: F = find, 
R = replace, A = add, and D = delete entries. 

When deciding which mode to use, you should consider the following: 

• If you merely want to find information and examine or report on it, you should open 
the data base with a find (read) only mode, thus allowing other users as much capability 
as you can tolerate. For example, if you open with: 

5 the data base is locked for some operations and may slow the rate of activity 
somewhat. Of course, if mode 1 or mode 5 users are already accessing the data 
base, you have no choice. 

6 mode 2 users can replace entries, one mode 4 user can replace, add, or delete 
entries, or mode 8 users can read entries while you are using the data base. 

8 no replacing, adding, or deleting of entries is allowed by other users. 

7 you are the only one accessing the data base. 

An important advantage of using modes 5 through 8 is that the data base is opened for read- 
ing only. As a result, you are more likely to gain access to the data base by avoiding restric- 
tions due to the MPE account structure. Also, the files are not marked for inclusion in the 
MPE system back-up tapes (SYSDUMP) since they are not altered in any way. This saves 
time when the daily system back-up procedure is executed. 

• If you want to find information and replace data in existing entries but do not need to 
add or delete any entries (and do not want anyone else to add or delete entries), you 
should open the data base with mode 2. 
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FINO ONLY FINP ONLY FIND ONLY 




FIND ONLY UNIQUE MODE FIND ONLY 
A USER 
F.R.A.P 




J^O^ INDICATES FIND ONLY CAPABILITY 



INDICATES TOTAL CAPABILITY (FIND, REPLACE, 
ADD, DELETE) 



FIND ONLY F^R flMPONUY 



Figure 1-3. IMAGE/QUERY Environments 
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• If you want to perform all the operations including adding and deleting entries, you 
should open with one of the following modes : 

1 if you want QUERY to use lock and unlock while performing the operations 

and to allow other users to add and delete entries during your session. The com- 
ments for mode 5 above apply here also. 

4 if you want to have exclusive ability to change the data base but will allow mode 
6 users to read while you are making the changes. 

3 if you want or must have exclusive access to the data base. 
LOGGING AND MODE SELECTION 

Opening the data base in one of modes 1 through 4 allows data base modifications to be 
logged to a logfile and subsequently recovered if there is a system failure. If the data base 
administrator has enabled the data base for logging, certain requirements of the logging system 
must be met before the data base can be accessed in one of modes 1 through 4. 

These requirements are the responsibility of the data base administrator and console operator, 
and are discussed in the IMAGE Reference Manual. If £my of these requirements are not 
satisfied, an IMAGE error message is returned. 

MPE FILES 

For those readers who are not familiar with the MPE Operating System, here is a brief intro- 
duction to some MPE concepts you may need to understand while using QUERY. 

MPE treats input/output devices as files with standard names. For example, $STDLIST is 
the name of the standard output file for both session and job modes. A file is equated to a 
device class which may be a line printer, terminal, disc, or other peripheral device. $STDLIST 
is normally equated to a terminal in session mode and to a line printer in job mode. The 
system manager defines the various device classes and sets up the correspondence between 
device classes and standard files. 

QUERY uses a file named QSLIST to allow you to alter the normal output device to any 
other output device. You must use an MPE :FILE command to equate QSLIST to the de- 
vice class you select. (The default device class is "LP".) You then use the QUERY 
OUTPUT= command to change the output file from $STDLIST to QSLIST. The method for 
doing this is explained in detail with the OUTPUT= command in Section II. The system 
manager can tell you what the various device types on your system are. 

Some QUERY commands accept input from MPE ASCII files. ASCII files contain ASCII 
characters (see Appendix B) and may be in card, disc, or magnetic tape format. You can 
use EDIT/3000 to create these files. See the terminal user's guide, Using the HP 3000, 
for instructions on how to create and edit files. 
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QUERY/3000 CHARACTER SET 

The following ASCII characters are defined as the QUERY character set: 

A through Z 

a through z 

0 through 9 

+ -*/?'#& @ % 

All other characters are referred to as "special" characters. When you encounter the term 
special characters in the following sections, it refers to all characters which are not part of 
this set. Blanks are special characters. 

Lowercase characters are always upshifted (changed to uppercase) unless they are part of a 
literal or values for a data item of type X. 

The complete ASCII character set is shown in Appendix B. 
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OPERATING QUERY/3000 



SECTION 



QUERY can be run in either job (batch) or session (interactive) mode. In session mode, 
QUERY carries on a dialogue consisting of command prompts, error messages, and other 
messages of general interest to you. The manner in which QUERY proceeds depends upon 
your responses to QUERY messages and prompts. In job mode, QUERY reads commands 
and other input from the job input device. No dialogue occurs although QUERY does issue 
error and other messages informing you of action taken. It is your responsibility to antici- 
pate the proper command and input sequence when operating in job mode. 

When entering information in session mode, remember that you can delete one or more 
previously typed characters by entering a Control H character for each character you want 
to delete. You can delete the current line with Control X. Control characters are entered 
by pressing the Control key and holding it down while pressing the appropriate letter key. 



USING QUERY IN SESSION MODE 

To use QUERY in session mode, you must perform the following tasks: 



® 

return 

! HELLO BPOWN. DATAMGT 
SESSION NUMBER = #S56 
WED., DEC 17 J 197 5., 10:49 AM 
HP32000C.00.E1 

:PTTN QUERY. PUB. SYS 



Press return. MPE prints a colon to indicate 
it is ready for a command. Log on to MPE 
using the HELLO command. 

MPE prints information about your session 
and another colon. 

Initiate QUERY execution with the RUN 
command. 



HP3??1 6A. 03. 00 OUEPY/3000 WED., DEC 17., 1975., 10:51 AM 



QUERY responds with an opening message. 

(;)UEPY/3000 READY 



> 



QUERY prints the "greater than" symbol 
when it is ready to accept a command. 



If you do not understand the log-on procedure or MPE prints an error message, you should 
consult the first section of Using the HP 3000 (see Preface for part number) which explains 
the procedure in detail. 

Before you can actually access a data base you must specify a data base name, password, and 
access mode. Normally you will do this at the beginning of your QUERY session by using 
the DEFINE command or the DATA-BASE= command. You can use some QUERY 
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commands without identifying the data base as you will see when you become more 
familiar with all the QUERY commands. 



The DEFINE command also allows you to define the procedure file, the output file 
(device), and the data set list. These parameters are all described in detail with the 
environment commands which follow in this section. 



® 



>DEFINE 



>>STO^E 



DATA- BASE 

PASSWORD = >> CLERK 
MODE = >>1 
DATA- SETS = >> return 
PPOC-FILE = >> MANPROC 
CTJTPUT = TERM 
OUTPUT = > > return 

or 



> B=5T0PE 
PASSWORD = 
MODE = >>5 
>P=PROCX 



>>BTJYER 



Define the QUERY operating environment as 
shown here or by using the individual environment 
commands as shown below. Both methods are 
explained later in this section. The DEFINE 
command causes prompts to be issued for each 
environment parameter. 



QUERY prints two "greater than" symbols when 
prompting for command parameters or additional 
input. 



Once the environment has been established, QUERY issues the > prompt again indicating 
that it is ready to accept a command. 
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> HALP 
INVAL I D 
>HELP 



COMMAND 



Each command you enter is checked for cor- 
rect form. If the command is incorrect, 
QUERY prints an error message and prompts 
you for another command. You may enter 
the correct version of the command or a 
different command. 



QUEPY COMMAND SET 



ADD 
ALTER 
CREATE 
DATA- EASE 
DATA- SETS 
DEFINE 

DELETE 
DESTROY 
DI SPLAY 
E>fIT 
FIND 
FORM 
HELP 
LIST 
• 



ADDS DATA ENTRIES TO THE DATA BASE 
EDITS PROCEDURES IN THE PROC-FILE 
STORES PROCEDURES IN THE PROC-FILE 
SPECIFIES DATA BASE 
SPECIFIES DATA SETS 

LISTS THE CURRENT STATE OF THE ENVIRONMENT 
COMMANDS AND PROMPTS FOR CHANGES 
REMOVES DATA ENTRIES FROM THE DATA BASE 
DELETES PROCEDURES FROM THE PROC-FILE 
DISPLAYS PROCEDURES IN THE PROC-FILE 
TERMINATES QUERY EXECUTION 
LOCATES DATA ENTRIES IN THE DATA BASE 
DISPLAYS THE STRUCTURE OF THE DATA BASE 
LISTS A DESCRIPTION OF THE QUERY COMMAND SET 
PRINTS DATA SET ITEM VALUES 



© 



> break key pressed 

! FILE OSLIST; DEV=TAPE 

: RESUME 



READ PENDING 



© 



< CONTROL Y > 



If you need to return control temporarily to 
the operating system, press the break key. 
Control transfers to MPE which prompts you 
for a command with a colon. To return con- 
trol to QUERY, enter a RESUME command. 
MPE prints READ PENDING to tell you 
QUERY is waiting for a command. In this 
case QUERY does not print the > prompt. 



If you want to terminate the execution of a 
QUERY command and return control to 
QUERY command mode, press Control Y. 
QUERY prints KControl Y> and prompts 
for a new command. 
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® 

> EXIT 

END OF PROGRAM 
:BYE 



CPU (SEC) = 33 

CONNECT CM IN) = 15 

WED^ DEC 17 J 1975^ 11:10 AM 

END OF SESSION 



Enter the EXIT command to terminate 
QUERY execution. Control returns to the 
operating system and you are prompted with 
a colon for an MPE command. 

To terminate the session, enter the BYE com- 
mand. The operating system reports the 
number of seconds of CPU time used as well 
as the number of minutes you were connected 
to the system. 



USING QUERY IN JOB MODE 

In job mode, QUERY reads commands and other input through the job input device 
(normally a card reader). All output goes to the device designated as $STDLIST, which is 
normally a line printer. Only the first 72 characters of each record are processed; the 
remaining characters in the record are ignored. QUERY commands consisting of more than 
72 characters can be continued on following records by entering an & as the last non-blank 
character in the record to be continued. 

It is your responsibility to anticipate the proper order of input. If a command is out of 
sequence or incorrectly entered, QUERY issues an error message. A file read or write error 
causes QUERY to terminate the job. 

It is also your responsibility to specify the data base to be accessed using the DATA-BASE= 
command, and the procedure file to be used through the PROC-FILE= command. Figure 2-1 
shows a card deck used to operate QUERY in job mode. The QUERY environment com- 
mands are described in detail later in this section. 

If QUERY is unable to open the data base for any reason, it automatically terminates. 
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© 



® 



MPE NOW HAS CONTROL SO THE RECORD 
MUST CONTAIN A COLON. TERMINATE 
THE JOB WITH AN EOJ COMMAND. 



:EOJ 



(e) TERMINATE QUERY EXECUTION 
WITH AN EXIT COMMAND. 



EXIT 



PLACE QUERY COMMAND 
RECORDS IN THE ORDER 
THEY ARE TO BE EXE- 
CUTED. (REPOl AND 
FIOI ARE THE NAMES 
OF PROCEDURES 
STORED IN THE 
PROC-FILE.) 



REPORT REPOl 



FIND FIOI 



PROC-FILE = PR0C1 (T) SPECIFY THE PROCEDURE FILE TO BE 

USED. THE FILE NAME IN THIS 
EXAMPLE IS PR0C1. 



MANAGER 



DATA-BASE = PROJ 



SPECIFY THE DATA BASE (PROJ) TO BE 
ACCESSED AND SUPPLY THE LEVEL WORD 
(MANAGER) AND ACCESS MODE (3). 



:RUN QUERY.PUB.SYS (2) THE NEXT RECORD CONTAINS A RUN COM- 
MAND TO INITIATE QUERY EXECUTION. 



:JOBMGR.HARDPUB ® 



THE FIRST RECORD OF THE 
BE AN MPE JOB COMMAND. 



NPUT FILE MUST 



Figure 2-1. Job Mode Operation 
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ASSIGN 



Allows a user to disable or enable an option. The only option currently supported by the 
ASSIGN command is LOCKOPTION. 



The form of the ASSIGN commEind is 

ASSIGN I option = j ON | 
AS j \ OFF j 



For example : 

ASSIGN LOCKOPTION = OFF 
A 

option 

where option is the name of an option whose default 

state is "on" but can be set to "off". 
It may subsequently be reset to "on" 
by the user (currently applies only to 
LOCKOPTION). 

When LOCKOPTION is on (default state), QUERY always locks any data base opened in 
mode 1 or 5 while any FIND and REPORT commands are executing in order to ensure that 
the resulting report does not contsiin errors due to dynamic changes made by other users 
concurrently accessing the data base. In some environments, this may be overprotective if 
you are sure that no other user is concurrently modifying the data pertinent to your FIND 
and REPORT commands. For example, protection may be provided through exclusive 
assignment of passwords or through exclusive scheduling of tasks. In such cases, automatic 
locking by QUERY can needlessly increase response time for other users. By setting the 
LOCKOPTION to "off", you inform QUERY not to lock any data base opened in mode 1 
or 5. 

The LOCKOPTION can be set off or on at any time and remains in effect until it is reset by 
a subsequent ASSIGN command. To determine the current state of the LOCKOPTION, use 
the SHOW command. 
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DEFINE 



Lists the status of all of the Environment commands and enables you to change the 
environment specifications. 



The form of the DEFINE command is 

DEFINE ) 
DEF ( 



When you enter the DEFINE command in either session or job mode, QUERY lists the state 
of each of the Environment commands and prompts you for changes. After the prompt, 
you may enter a new parameter for the command, or press return to maintain the current 
value. 

When DEFINE is entered in job mode, you must anticipate the order of QUERY prompts 
and enter the new values in the proper order on the records immediately following the 
DEFINE command. A blank record indicates no change in value (like return in session 
mode). 

The prompts (shown without replies) are: 

DATA- BASE = >> 
PASSWORD = >> 
MODE = >> 
DATA- SETS = >> 
PROC-FILE = >> 
OUTPUT = >> TERM 
OUTPUT = >> 



When you first use the DEFINE command after initiating QUERY execution, none of the 
command settings will be listed except OUTPUT=TERM. If you do not want to define a 
particular environment parameter respond with return. If you are only doing procedure 
maintenance you need not specify a data base. On the other hand, if you are not using 
procedures you do not have to define a Proc-file. 

See the command descriptions which follow for details about the purpose of each 
environment specification. 
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DEFINE 



EXAMPLE 



The DEFINE command can be used to set up the environment for your QUERY session. 



QUERY/3000 READY 
> DEFINE 

DATA- BASE = >> STORE 
PASSWORD = >> CLERK 
MODE = >>5_ 
DATA- SETS = >> return 
PROC-FILE = >> MANPROC 
OUTPUT = TERM 
OUTPUT = >> return 



QUERY prompts for the data base 
name, the password, mode, data 
set list, and procedure file name. 
The current output device is the 
terminal. If you do not want to 
change it, reply with return. 



The command is also useful to list the current environment and change it. 



> DEFINE 

DATA-BASE = STORE 
DATA- BASE = > > return 
PASSWORD = CLERK 
PASSWORD = >> return 
MODE = 5 
MODE = > > return 
DATA- SETS = > > return 

PROC-FILE = MANPROC. IMAGE. DATAMGT 
PROC-FILE = >> CANNED 
OUTPUT = TERM 
OUTPUT = » return 



Once the environment has been 
defined, QUERY prints the current 
setting for each environment com- 
mand and allows you to change it 
or press return to leave it as is. 



The Proc-file is changed from 
MANPROC to CANNED. 



2-7 



DATA-BASE = 



Specifies the data base which is to be accessed. 



The form of the DATA-BASE= command is 
( DATA-BASE= 



u- 



data base name 



For example, 

>DATA-BASE= PAYROLL 
data base name — 



where 



data base name 



is the name of an IMAGE/ 3000 data base. 

The data base may reside in any group or 
account on the local HP 3000 or a remote 
HP 3000, as long as you are allowed access 
to it through the MPE file security. To spe- 
cify a data base that does not reside in your 
group and account, you must use a fully- 
qualified name in the form: data base name, 
group.account. For example, STORE.PUB.SYS 
is a data base named STORE in the PUB group 
of the SYS account. 

If you want to access a remote data base, you 
may specify the name of a data-base-access 
file as the data base name. A data-base access 
file contains the name of a remote data base 
and the commands to establish a communi- 
cations link and remote session with another 
HP 3000 computer. 

Refer to the IMAGE Reference Manual for 
more information about how to create data- 
base-access files and to Appendix D for a 
description of available methods for accessing 
a remote data base using QUERY. 



This command is used to specify which data base is to be accessed. You must use either this 
command or the DEFINE command to identify the data base you want to use before you 
can use any QUERY commands which access a data base. You may change the data base 
you are accessing at any time. 



2-8 



APR 1978 



DATA-BASE = 



When you enter this command, QUERY prompts you for a password with the message: 
PASSWORD=» 

Passwords are created by the data base administrator or designer who will tell you which one 
you may use. The password determines which data items you are allowed to read or write 
in the data base. 

After you enter an appropriate response, QUERY prompts you for the desired access mode 
with the message: 

MODE=» 

You must enter a valid access mode represented by a number between 1 and 8. The descrip- 
tion of modes in Section I will help you determine which mode to use. 

QUERY checks both prompt responses for validity and issues an error message if any of the 
answers is incorrect. 

PASSWORD= and MODE= may also be used as commands. Descriptions of these commands 
follow. 

If the DATA-BASE= command is entered in batch mode, the password and the mode num- 
ber must follow the command in the next two records, respectively. If no password is 
required for the data base, the record following the command must be blank. 

When you enter this command, QUERY first closes the current data base before attempting 
to open the new data base requested in the command. Therefore, if QUERY is unable to 
open the requested data base for some reason, you must specify a different data base to be 
accessed through the DATA-BASE= or the DEFINE command or terminate QUERY. 



EXAMPLES 



>DATA-BASE= STORE 



PASSWORD = 
MODE = >>3 
> 



>> BUYER 



Specify access to the STORE data base. 
Provide a password, BUYER, and a 
mode, 3, requesting exclusive read and 
write access to the data base. 



> B= STORE. IMAGE 
PASSWORD = >> CLERK 
MODE = >>5 

DATA BASE OPEN IN ANOTHER MODE 

> B=STORE» IMAGE 
PASSWORD = >> CLERK 
MODE = >>6 



Specify the data base STORE.IMAGE 
and password CLERK. 
Mode 5 is not allowed because other 
users are in incompatible modes. Mode 6 
is used instead. 
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PASSWORD= 



Changes your password. 



The form of the PASSWORD= command is 



PASSWORD= I 

> password 



For example, 



>PASSWORD= BOSS 
password 




where password is the word you have been given by the data 

base administrator to use when accessing 
the data base. 

You may change your password, and thus, the group of data to which you have access. 
QUERY first closes the current data base before attempting to open the data base with the 
new password. 



EXAMPLE 



> PAS= CLERK 
>AD INVENTORY 
ILLEGAL ACCESS 
> PAS=DO-ALL 
> AD INVENTORY 
STOCK # 



Specify CLERK password. 
A request to add an entry to the 
INVENTORY data base is rejected 
since CLERK does not allow write 
access to it. If the password is changed 
to DO-ALL, QUERY allows the user 
to add to the INVENTORY data set. 
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IVIODE = 



Changes the mode of access to the current data base. 



The form of the MODE= command is 
( MODE= ^ 



M= 



mode number 



For example, 
MODE= 3 



mode number- 



where 



mode number 



is a number (an integer) in the range of 
1 to 8 representing the access mode 
you want to use. 



You may use this command to change your mode of access to the data base. If the MODE= 
command is entered, QUERY first closes the current data base before attempting to open 
the data base with the new access mode. 



EXAMPLE 



>M0DE=6 

>AD INVENTORY 

ILLEGAL ACCESS 

> M0DE=3 

>AD INVENTORY 

STOCK # 

ONHANDQTY 

SUPPL I ER 

UNIT-COST 

LASTSHIPDATE 

BINNUM 



=>>6650D22S 



= >> H 
= >>H & 



5 SURPLUS 



=>> 1395 
= >> 121575 
= >>3 



A mode of 6 is specified. 
Since mode 6 does not allow write 
access to the data base, the user must 
change to a mode which allows such 
access and then QUERY allows the 
addition of an INVENTORY entry. 



STOCK# 
> 



;>>// 
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DATA-SETS = 



Informs QUERY which data set to access in the event that a data item name which appears 
in more than one data set is used in a FIND or LIST command. 



The form of the DATA-SETS= command is 

DATA-SETS= ) 

/ [data set list] 



For example, 

DATA-SETS= PAYROLL,ACCTREC 
data set list 

or 

DATA-SETS= 

where data set list is a list of data sets you want to 

access, each data set name separated 
from the next one by a comma. If 
data set list is not included, the set 
list is cleared. 

In an IMAGE/3000 data base, the same name may be used for different data items if each 
appears in a different data set. As mentioned in Section I, you may use a "fully -qualified" 
data item name {data set name. data item name) to tell QUERY exactly which data item you 
want to access. However, if you are referring to several item names which appear in multiple 
data sets, a command could become quite lengthy. The DATA-SETS= command may save 
you some effort. 

The DATA-SETS= command defines a list of one or more data sets. When you use a FIND 
or LIST command and QUERY encounters a data item name which appears in more than 
one data set but is not "fully-qualified", it checks the data set list to help resolve the 
ambiguity. 

DATA SET SELECTION RULES 

In session mode, if you reference a data item appearing in more than one data set, QUERY 
resolves which data set to use according to the following rule: 

• If one (and only one) of the data sets containing the data item appears in the data set 
list, QUERY automatically uses that data set. Otherwise QUERY prompts you to 
supply the desired data set with the message: 
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DATA-SETS- 



data item name IS A MEMBER OF THESE SETS: 

data set name, data set name, 

WHICH SET DO YOU WISH TO USE? 

»dafa set name 

You must type the name of the data set you want to access. If the name you provide 
does not match the names hsted, QUERY repeats the prompt. If you decide you do 
not want to access the listed data sets, you may abort the command by pressing return 
instead of entering a data set name. You will be prompted for another command. 

In job mode, QUERY cannot prompt you for the desired data set in the event there is 
ambiguity. The data set to be accessed is chosen according to the following rules: 

• If exactly one data set containing the data item appears in the data set list, QUERY 
uses that data set. 

• If more than one of the data sets containing the data item appears in the data set list, 
QUERY uses the last data set mentioned in the list. 

• If no data set containing the data item is in the data set list, QUERY accesses the last 
data set (containing the data item) defined in the data base schema to which you have 
access. (The schema is the source description of the data base prepared by the data 
base designer.) You may want to use the FORM data item name command in session 
mode before you prepare your job to determine the order in which data sets contain- 
ing the item appear in the schema. You can then decide what to include in the data 
set list. 

In job mode, QUERY always informs you which data set was chosen (in case of ambiguity) 
with this message: 

data item name IS A MEMBER OF THESE SETS: 

data set name, data set name, 

data set name USED 

AUTOMATIC DATA SET LIST ADDITIONS 

If a FIND or LIST command is executed which contains an unqualified data item name 
(i.e., a data item without a preceding data set name), QUERY automatically adds the name 
of the accessed data set to the data set list. This occurs whether the named data item 
appears in more than one data set or not. 

To avoid any ambiguity when the same data item appears in multiple data sets, you can 
either: 

• use fully-qualified data item names in all commands, or 

• always reset the data set list (using the DATA-SETS= command) prior to entering a 
command using a data item which appears in multiple sets. 
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DATA-SETS = 



EXAMPLES 



> SETS=MUD> INVENTORY, SALES 
ILLEGAL DATA SET NAME MUD 
> DEF 

DATA-BASE = STORE. IMAGE 
DATA-BASE = > > return 
PASSWORD = DO-ALL 
PASSWORD = >> return 
MODE = 1 



Enter the data set names you want 
in the list. If a name is invalid an 
error is printed. 



If you use the DEFINE command, 
you can see which sets are currently 
in the list. The valid data set names 
are now in the list. 



MODE = > > return 

mTA-SETS = INVENTORY, SALES 
DATA-SETS = > > return 
PROC-FILE = >> return 
OUTPUT = TERM 
OUTPUT = >> return 



The next example illustrates how QUERY uses the data set list, clears it, and enters data 
set names automatically. 
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DATA-SETS = 



■ALL 
= > > return 



IMAGE. DATAMGT, 



> DEFINE 

DATA-BASE = STORE. IMAGE 
DATA- BASE = >> return 
PASSWORD = DO- 
PAS SWORD 

MODE = 1 
MODE = > > return 
DATA- SETS = SALES 
E»\TA-SETS = > > return 
PROC-FILE = MANPROC 
PROC-FILE = > > return 
OUTPUT = TERM 
OUTPUT = > > return 
> FIND 5TOCK#=6650Dg2S 
2 ENTRIES QUALIFIED 

> DATA-5ETS= 

> FIND STOCK#=6650Dg2S 
STOCK # IS A MEMBER I 

PRODUCT, SALES, INVENTORY 
WHICH SET DO YOU WISH TO USE? 
» INVENTORY 
5 ENTRIES 
>DEFINE 



.The data set list currently contains 
the SALES data set name. 



y/hen searching for entries with 
STOCKf^=6650D22S, the SALES 
data set is automatically used since 
it is in the set list. 



If the set list is cleared, QUERY^ 
asks which set you want to use. 



THESE SETS: 



QUALIFIED 



STORE. IMAGE 
> > return 



DATA- BASE = 

DATA- BASE = 

PASSWORD = DO-ALL 
PASSWORD = >> return 
MODE = 1 
MODE = >> return 
DATA- SETS 
DATA- SETS 
PROC-FILE 
PROC-FILE 
OUTPUT = 
OUTPUT = 
>FIND 

2 ENTRIES QUALIFIED 

> FIND SALES. ST0CK#=7391Z22F 

8 ENTRIES QUALIFIED 



= INVENTORY 

= > > return 

= MANPROC. IMAGE. DATAMGT 
- >> return 
TERM 
>> return 
ST0CK#=7391Z22F 



. INVENTOR Y was automatically 
placed in the data set list when 
specified in the FIND command 
above. 



Now QUERY automatically searches 
the INVENTORY data set unless 
the data item name is qualified with 
another data set name as shown 
here with SALES. 
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PROC-FILE= 



Specifies the name of the current procedure file. 



The form of the PROC-FILE= command is 



PROC-FILE= ( 

/ filename [,n] 



For example. 



PROC-FILE=FILEP, 50 



filename 




where filename is the name of an MPE ASCII file. 

The file may reside in any group or 
account, as long as you are allowed 
access to it through the MPE file 
security. To specify a file that is not 
local to your group and account, you 
must use a fully-qualified file name in 
the form: file.group.account. For 
example, SPEC.PUB.SYS is a file 
named SPEC in the PUB group 
account of the SYS account. 

n is the number of records in the file. 

The file may be from 5 to 400 records 
in length depending upon the number 
and length of procedures to be stored. 
(The default value is 126.) Each 
procedure is stored on a record 
boundary, and occupies one or more 
records. 

The file used to store FIND, REPORT, and UPDATE commands as procedures is known as 
the Proc-file. Before using any of the QUERY procedure commands, you must specify the 
name of the Proc-file. This definition stays in force until changed (using PROC-FILE= or 
DEFINE) or until execution terminates. 

If the file name does not exist, QUERY issues a message and opens and saves a disc file of 
size n with the specified file name using a file code of 1070. 

If n is specified for an existing file, it is ignored. 
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PROC-FILE= 



Once a Proc-file has been declared, QUERY always uses that file when executing any of the 
following commands: 

CREATE 

ALTER 

DISPLAY 

DESTROY 

RENAME 

FIND procedure name 
UPDATE procedure name 
REPORT procedure name 

If you have not specified a Proc-file before entering one of these commands, QUERY prints 
an error message. 



EXAMPLES 



>PROC-FILE=MANPROC 
>DI SPLAY LIST 



MANPROC contains the listed 
procedures. 



Fl 



LP3 



UPDl 



REP4 



ZAP 



> P= CANNED 

>DI SPLAY LIST 



CANNED contains three 
procedures. 



XXX 



YYY 



ZZZ 



> PROC-FILE=PROCX 

FILE DOES NOT EXIST, BEING CREATED 



You can create a Proc-file with 
the PROC-FILE= command. 
If you do not specify the number 
of records QUER Y creates a file 
with 126. 



> 
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OUTPUT= 



Selects the output device for the FORM, HELP, DISPLAY, LIST, REPORT, and VERSION 
commands. 



The form of the OUTPUT= command is 



OUTPUT= I \ TERM 
0= 1 I LP 



For example, 



OUTPUT=LP 



or 



OUT= TERM 



where TERM indicates that output is to be displayed 

on the device specified in the MPE 
operating system as $STDLIST. 
($STDLIST is normally a terminal in 
session mode and a line printer in job 
mode.) 



LP indicates that output is to be sent to the 

file designated as QSLIST. QSLIST is 
equated to the MPE device class LP 
(line printer) unless you use an MPE 
: FILE command to specify otherwise. 
See below. 



The default output device for the commands listed above is $STDLIST unless you use this 
command to change it. You can also use this command to change the output device back 
to $STDLIST at any time after setting it to QSLIST. 

If you want to associate the file named QSLIST with a device other than the line printer 
you must use the MPE FILE command and then set OUTPUT=LP. 



The form of this command is: 



:FILE QSLIST; DEV= device type 



where device type is a name referring to a class of devices or a specific device. The 
different device classes and names are set up by the system manager at the time the 
MPE operating system is configured. You must ask the system manager which name to 
use for the device you want to associate with QSLIST. 
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OUTPUT= 



QUERY will not output a record longer than 136 bytes (characters) even though the 
maximum record length for the device may exceed this limit. 

An example of a :FILE command used to divert output to a magnetic tape is: 

:FILE QSLIST;DEV=TAPE 

In this case, TAPE is the name of the class of devices known as magnetic tapes. 

If you want to change the device associated with QSLIST while operating QUERY in 
session mode, you must use the break key or terminate QUERY and return to the MPE 
operating system before entering the : FILE command or enter it before running QUERY. 

If you are operating in job mode, you may place a :FILE command in your job preceding 
the :RUN QUERY command. 

All error messages and QUERY prompts are always sent through the $STDLIST device, 
regardless of whether OUTPUT=TERM or OUTPUT=LP. 



EXAMPLES 



QUERY is running in session mode. QSLIST is equated to a terminal initially. 



> OUTPUT=LP 
> LIST INVENTORY 
>OUT=TERM 
>LIST INVENTORY 



STOCK# 



ONHANDQTY SUPPLIER 



Change output device to QSLIST. 

The INVENTORY data set is listed on the 

line printer. 

Set output device to terminal again. 

The INVENTORY data set is listed on the 

terminal. 

UNIT-COS LASTSH BIN 



6650D22S 
2457A1 1 C 
3586T14Y 



5306 
1 1001 345 
144 



ACME WIDGET 
ACME WIDGET 
CARDINAL MILLS 



1427 120375 3 
5031 120175 1 
249 112075 2 
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OUTPUT= 



The next example illustrates the method for sending output to a tape device. In this case, a 
procedure from the Proc-file is listed first on the terminal and then on a tape. 

> DI .SPLAY FNAMES List a procedure named FN AMES. 

PPOCEDTJRE: FN AMES 
00 1 FIND LAST-NAME="" END 



> break key is pressed 

; f1le qslist; DEV=TAPE 

; RESUME 

READ PENDING 

OUTPUT=LP 

> DI SPLAY FNAMES 

>OUTPUT=TERM 



Press the break key and equate QSLIST to 
a magnetic tape device. Resume QUERY 
execution. Change the output device to 
QSLIST. Write the procedure to the QSLIST 
device. Set the output device to the termi- 
nal again. 
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OUTPUT= 



In this example, QUERY locates a specific entry. The same procedure is followed as above 
except QSLIST is equated to a disc file named SAVER which MPE creates. 



>FIND CUSTOMER. LAST-NAME IS CORCORAN END Retrieve data with FIND 
USING SERIAL READ command. 
1 ENTRIES QUALIFIED 
>REPORT ALL 



ACCOUNT 
LAST -NAME 
FIRST-NA^4E 
INITIAL 

STREET-ADDRESS 

CITY 

STATE 

ZIP 

CREDIT-RATING 



=54283540 
=CORCORAN 
=CLIFFORD 
= C 

=6105 VALLEY 

=CARMEL 

= CA 

=93921 

= 7. 1 0000 



Report on data. 



GREEN DR. 



> break key is pressed 

; FIL E QSLIST=SAVER.>NEW; DEV=DI SC 

t RESUME 

R£AD PENDING 

OUTPUT=LP 

> REPORT ALL 

>EXIT 



Press the break key and 
define a new file named 
SA VER. Then resume 
QUER Y execution. Use 
OUTPUT=LPand REPORT 
ALL commands to write 
data in the SAVER file. 
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EXIT 



Terminates QUERY execution. 




You may enter the EXIT command whenever QUERY prompts for a command. QUERY 
execution terminates and control is returned to the operating system. The operating system 
then prompts you for a command with the colon (:) prompt character. 

You must use an EXIT record to terminate a set of QUERY commands entered as a job. 
The EXIT record should be followed by an MPE command record (usually :EOJ). 



EXAMPLE 



> EXIT 

END OF PPOGPAM 
:BYE 

CPU (SEC) = 33 

CONNECT <MIN) = 15 

TUE.> JAN 13.. 1976> 9:02 AM 

END OF SESSION 
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FORM 



Lists information about the data base currently being accessed. 



The form of the FORM command is 






data set name 




( FORM ) 

)fo ] 


data item name 
SETS 
ITEMS 
PATHS 





For example, 
FORM 



or 



or 



or 



FO PATHS 

FORM DSETl 

data set name 

FO FNAME 

data item name ■ 




where 



data set name 



data item name 



SETS 



ITEMS 



PATHS 



is the name of a data set in the data base 
currently being accessed. 

is the name of a data item in the data base 
currently being accessed. 

tells QUERY to list information about each 
data set in the data base to which you have 
access. 

tells QUERY to list information about each 
data item in the data base to which you have 
access. 

tells QUERY to list the relationship between data 
sets in the data base to which you have access. 
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FORM 



FORM provides information about the current data base. The information contains only 

the names of data sets and data items to which you have at least read access. No other data 
sets and data items are listed. If a data base is not currently defined, QUERY issues a mes- 
sage and prompts you for another command. 

If OUTPUT=TERM, the hsting is sent to the standard list device for the job or session. If 
OUTPUT=LP, the listing is sent to the file named QSLIST. See the OUTPUT= command for 
information about QSLIST. 

Figures 2-2 through 2-7 illustrate the output resulting from each FORM command option. 
If you enter FORM name and name refers to both a data item and a data set, the data set 
information is listed. If a data set or a data item has the name SETS, ITEMS, or PATHS, it 
is treated as a keyword parameter when used in a FORM command. 

The FORM PATHS output shown in figure 2-4 lists the detail data sets associated with each 
master data set and the master data sets associated with each detail. It also lists the detail 
set item which is used as a key (search item name) and the detail set item which is used for 
sorting (if any). 



Current 

Data Base Name 



DATA BASE! STORE 



I TEMS } 



Since Number of 
Subitems = 1, 
QUERY does 
not print it. 



^ Item Name 


\sJ2^ 


ACCOUNT'*'^ 




CITY 


X12 


CSEOIT-RATING 


R2 


DATE 


X6 


FIRST-NAME 


XIO 


IVITlAU 


U2 


I aST-N AME 


X16 


P JRCH-DATE 


X6 


STATE 


X2 


STOCKx 


U8 


STREET-APDRESS 


X26 


TOTAL 


J2 


ZIP 


X6 



TUE, JAN 13, X976, I U 29 AM 

T 

Current date 
Item type ""'^ ^ime 

and length 
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Figure 2-2. FORM ITEMS Output 



FORM 



Current Data Base Name 



V 



Current Date and Time 



DATA BASE: STORE 



serst 

CUSTOMEP? 

DATE-MASTER 

SALES 

Data Set Name 



TUE, s/AN 13, 1976, UJ29 AM 



ITEM ENTRY 
TYPE COUNT CAPACITY COUNT 



ENTRY BLOCKING 
LENGTH FACTOR 



M 
A 
D 



9 
1 
4 



Data Set Type 
M = Master 
A = Automatic 
D = Detail 

Number of items 
in each data set 
entry. 



aoo3 

12012 

Maximum 
number of 
entries each 
set can 
contain. 



15 
18 
13 



41 
3 

19 
i 

Number of 
computer 
words per 
entry 



10 

P? 

14 



Number of entries 
currently stored 
in each data set. 



Maximum number 
of entries a block 
can contain. 



Figure 2-3. FORM SETS Output 



DATA BASE! STORE 



PATH IDENTIFYING INFORMATION 



TUE, JAN 13, 1976, 1 U 29 AM 



MASTER SET NAME 

COSTOMER 

DATE-MASTER 



ASSOCIATED 
DETAIL SET NAME 

SALES 

SALES 



SEARCH ITEM NAME SORT ITEM NAME 
ACCOUNT PURCH-OATE 
PURCH-DATE 



assocuted 

detail set name search item name sort item name master set name 
Sales account purch-date customer 

1ST0CK# 

PURCH-DATE DATE-MASTER 



Figure 2-4. FORM PATHS Output 
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FORM 



Data base name 
DATA 8ASEI STORE 



ITtM NAME! 
ACCOUNT 



Data item type 



!S A MEMBER OF THESE SETSI 
CUSTOMER 
SALES-* — 



Data set names 



Current date and time 



TUE, JAN 13, 1976, I U 29 AM 



Figure 2-5. FORM data item name Output 



Data base name 
t 

DATA BASE! STORE 

CUSTOMER is a manual 
master data set. 

SET MAMEj 

CUSTOMER, MAMUAL 

ITEMS! 







/ ACCOUNT, 


J8 






LAST-NAME, 




All these 




FIRST-NAME, 


xio 


items are 




INITIAU, 




in the 


< 


STREET-ADORESS, 




CUSTOMER 




CITY, 


xia 


data set. 




STATE, 


X? 






ZIP, 


X6 






^ CREDIT-RATING, 


R? 



Current date and time 



CAPACITY! 2003 



TUE, JAN 13, 1976, U 1 29 AM 

ACCOUNT is a key item 
linked to a detail data set. 



<<KEY ITEM>> 



EnTRIESI 15 



Maximum number of entries 
CUSTOMER can contain. 



Number of entries 
in the data set. 
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Figure 2-6. FORM data set name Output 



FORM 



Data Base Name 

DATA BASEI STORE 



SET MAMEl 

CUSTOMER, MANUAt'' 



CUSTOMER is a 
^Manual Master 
Data Set. 



Current date and time 



TUE, JAN 13, 1976, 11 1 2q AM 



All these items 
are in the 
CUSTOMER 
Data Set. 




ITEMS! 

ACCOUNT, 
UAST-NAME, 
FIRST-NAME, 
INITIAL, 
STREET-ADDRESS, 
CITY, 
STATE, 
ZIP, 
CREDIT-RATING, 

CAPACITYJ 2003 



SET MAMEJ 

DATE-MASTER, AUTOMATIC 

ITEMSJ 
DATE,. 

CAPACITYJ 2ir 



X16 
XlO 
US 

X18 

X6 
R? 

ENTRIES! 15 



<<KEY ITEM>> 



\ 



X6 



ACCOUT is a key to the 
detail set SALES which 
is linked to this Master. 
The detail search item is 
also named ACCOUNT. 
Number of 
entries in 
CUSTOMER 
data set. 



<<KEY ITEM» 



SET MAMEj 

SALES, DETAIL 

ITEMS! 

ACCOUNT, 

The SALES data set STOCKS, 

can contain at most ^°I^h'r««,E^ 
iomo 4. ■ PURCH-OATE, 
12012 entries. 

CAPACITYT*-12012 
PATH IDENTIFYING INFORMATION 



ENTRIES! 18 

DATE is a key item in DATE- 
MASTER linked to the SALES 
data set through the search item 
PURCH-DATE. 



J9 
U8 
J2 
X6 



<<SEARCH ITEM>> 
<<SEARCH ITEM>> 

«SEARCH ITEM, SORT ITEM>> 



ENTRIES! 13 

Data Set relations. 



MASTER SET NAME 

CUSTOMER 

DATE.MASTER 

DETAIL SET NAME 
SALES 



ASSOCIATED 
DETAIL SET NAME 

SALES 

SALES 



SEARCH ITEM NAME 

ACCOUNT 

PURCH-OATE 



SEARCH ITEM NAME SORT ITEM NAME 

ACCOUNT PURCH-DATE 
ISTOCK* 
PURCH-DATE 



PURCH-DATE is 
also used for 
sorting. 

SORT ITEM NAME 
PURCH-OATE 



ASSOCIATED 
MASTER SET NAME 

CUSTOMER 

DATE-MASTER 



Figure 2-7. FORM Output 
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HELP 



Lists information about the function, format, and parameters of QUERY commands. 



The form of the HELP command is 
HELP , 

command name 

H 



FUNCTION 
FU 



FORMAT 
FO 



PARAMETERS 
PA 



For example, 
HELP 

or 

HELP FORM FUNCTION 



or 




command name 



HE DEFINE 



where command name 

FUNCTION 
FORMAT 



consists of any valid QUERY command 
name such as DISPLAY, EXIT, or 
RENAME. You may use the short form of 
the command name (D, E, or REN). 

indicates that only the command's function 
should be printed. 

indicates that only the command's format 
should be printed. 



PARAMETERS indicates that only the command's 

parameters should be printed. 

The HELP command provides a convenient on-line reference for QUERY commands. If you 
enter HELP, you receive a list of the QUERY commands followed by a brief description of 
the function of each command. 

If you enter HELP command name, you receive information about the specified command's 
format, function, and parameters, if any. 

If you enter HELP command name followed by one or more of the parameters FUNCTION, 
FORMAT, or PARAMETERS, QUERY provides only the information that you request. 
That is, HELP FIND FUNCTION prints only the FIND command's function and no infor- 
mation about the format or the parameters, and HELP FIND FORMAT PARAMETERS 
(or HE FI FO PA) prints the format and parameters of the FIND command. 
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HELP 



HELP output is listed on the standard list device, unless OUTPUT=LP has been previously 
entered. In that case, the output is directed to the device equated to the QSLIST file. (See 
the OUTPUT command description of QSLIST.) 

In order to allow you plenty of time to read the command descriptions when using HELP in 
session mode, QUERY prints the following message after listing several lines: 

** PRESS ANY KEY TO CONTINUE 

When you are finished reading the descriptions currently displayed, press any terminal key. 
The listing will continue. 



EXAMPLES 

>H HELP FUNCTION 



FUNCTION - 

TO LIST INFORMATION ABOUT THE FUNCTION., FORMAT 
AND PARAMETERS OF QUERY/3000 COMMANDS 

You may abbreviate the HELP com- 
mand and the command you are 
>H B ask ing about. 



FUNCTION - 

SPECIFY THE DATA BASE TO BE ACCESSED 

FORMAT - 

DATA-BASE= DATA BASE NAME You can use Control Y to terminate 

the command description. 

PARAMETERS - 

DATA BASE NAME - NAME OF The order of FUNCTION, 

< CONTROL Y > PARAMETER, AND FORMAT 

parameters can vary. 

>HELP OUTPUT PA FO 



FORMAT - 

OUTPUT= TERM/LP 

PARAMETERS - 

TERM - INDICATES THAT OUTPUT SHOULD BE SENT 

TO THE DEVICE SPECIFIED AS $STDLIST 
LP - INDICATES THAT OUTPUT SHOULD BE SENT 

TO THE FORMAL FILE DESIGNATOR 'QSLIST' 
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SHOW 



Displays the ciirrent state of an option that can be enabled or disabled by the ASSIGN 
command. The only option currently supported by the ASSIGN and SHOW commands is 
LOCKOPTION. 



The form of the SHOW command is 




For example, 

SHOW LOCKOPTION 
option — I 
where option 

Example : 

>SHOW LOCKOPTION 
LOCKOPTION = ON 
> ASSIGN LOCKOPTION = OFF 
>SHOW LOCKOPTION 
LOCKOPTION = OFF 



is the name of an option supported by 
the ASSIGN command (currently 
applies only to LOCKOPTION). 



MAY 1979 
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VERSION 



Displays the current version of QUERY and IMAGE procedures and program files. 



The form of the VERSION command is 

( version) 

I V 



This command will print the current QUERY version, update, and fix level information and 
all IMAGE procedures and program files on the standard list device. If OUTPUT=LP has 
been specified previously, the information is also printed on the QSLIST device. (See the 
0UTPUT= command for a description of QSLIST.) 



EXAMPLE 



> VER5I0N 

QUERY A. 03. 00 

IMAGE PROCEDURES: 



DBOPEN 


A. 


04. 


.00 


DBINFO 


A. 


04< 


00 


dbclo.se 


A. 


04. 


00 


DBFIND 


A. 


04. 


00 


DBG ET 


A. 


04. 


00 


DBUPDATE 


A. 


04. 


00 


DBPUT 


A. 


04. 


00 


DBDELETE 


A. 


04. 


00 


DBLOCK 


A. 


04. 


00 


DBUNLOCK 


A. 


04. 


00 



IMAGE PROGRAM FILES: 

DBSCHEMA.PUB. SYS A. ^4.';^'^ 

DBSTORE.PUB. SYS A.'^4.'^<^ 

DBRESTOR.PUB. SYS A.'?!4.'^0 

DBUNLOAD.PUB. SYS A.?!4.00 

DBLOAD.PUB. SYS A. 04. 0(7! 

DBUTIL.PUB. SYS A.f74.'57l 
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LOCATING AND UPDATING DATA 



The commands described in this section locate data entries and modify the data base. The 
FIND command locates data and the UPDATE ADD, UPDATE REPLACE, and UPDATE 
DELETE commands modify data. 

The FIND command locates entries in the data base according to data item values in the 
entries and provides the following features: 

• Up to 50 logical relationships can be specified in one command, and up to 65,000 data 
entries can be located through one command. 

• More than one value can be specified for comparison with a data item. 

• The number of entries located (satisfying the logical relationships specified) is reported. 

• The FIND command itself can be stored in the Proc-file as a procedure (through the 
CREATE command) for repeated use without re-entering. FIND procedures can be 
created which prompt you for the desired search values at procedure execution time, 
allowing you to search for different values for the same data item each time the proce- 
dure is executed. 

• Entries may be located from a single data set and in some cases, from multiple data sets. 

The format of the FIND command varies with the command's usage. The four possible uses 
are: 

• locating entries in a single data set 

• locating all entries in a data set regardless of the value of the data item specified 

• locating entries in multiple data sets 

• executing a FIND command stored as a procedure. 

You may modify your data base in three ways: 

• Add data entries to a data set by using UPDATE ADD. 

• Delete data entries from a data set by using UPDATE DELETE. 

• Modify data entries in a data set by changing the values of data items not defined as 
search or sort items in the data base by using UPDATE REPLACE. 

UPDATE DELETE and UPDATE REPLACE are extensions of the FIND command, in that 
they operate on the entries selected by the last FIND command executed. UPDATE ADD 
does not require a previous FIND command. 

UPDATE commands can be stored as procedures in a Proc-file and used at a later time. The 
procedure must reside in the currently defined Proc-file. 

In order to use the UPDATE commands your mode must be less than 5. If you open the data 
base with MODE equal to 2, the only UPDATE command you may use is REPLACE. With 
mode 1, 3, or 4 you may use all UPDATE commands. 



SECTION 
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USING THE FIND COMMAND 

The FIND command consists of one or more logical relations consisting of a data item name, 
relational operator, and one or more values separated by commas. QUERY searches the 
appropriate data set(s) and stores the relative record addresses (in an internal buffer not 
directly accessible to you) of the data entries which satisfy the relations. The number of 
entries located is reported with the message: 

XXX ENTRIES QUALIFIED 

After the command is entered, QUERY may type the message: 

USING SERIAL READ 

This means that the data set must be searched in serial fashion without the benefit of master 
data set indexing. Serial searching can (in some cases) consume a great deal of time. You may 
abort the search by pressing Control Y if you decide you do not want to wait for its completion. 

Once data entries have been located they are available for listing (using the REPORT command), 
updating (using the UPDATE REPLACE command), or deleting (using UPDATE DELETE). 
The located entries remain available at any time until QUERY execution terminates, the entries 
are deleted, or another FIND command is entered. This means, for example, that located 
entries can be listed using one report format and then again using another format without using 
FIND again. 
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FIND 



Locates entries in a single data set. 



The form of the FIND command when used for this purpose is 

(find) 



If i 



relation 



[end] 



For example 



or 



FIND BADGE# IS "09.18" END 
relation 

FIND L-NAME IS CLEVER AND F-NAME IS JACK END 



w 

relation 



V 

relation 



or 



FI STATE IS "CALIFORNIA", "NEVADA", "WASHINGTON" END 

relation 



or 



FIND EMPLOYEE.SALARY 



data set name 



IGT 

\ 

relop value 



1000 END 

t 



data item name 



where 



relation 

data set name 
data item name 



relop 
value 



takes the form: 

[data set name.] data item name relop "value" [/'value". .] 

is the name of a data set in the current data base. 

is the name of a data item contained in the data base. If a 
data set name is used, the data item must belong to the 
specified data set. 

is a relational operator as shown in table 3-1 . 

is the data item value. It must be the same type and within 
the same value range as the data item named in the 
relation. Value need not be enclosed in quote marks (") 
unless the value contains special characters. Values which 
are not contained in quotes are upshifted. For example, 
California is converted to CALIFORNIA before it is 
compared to data item values in the data base. 
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FIND 



Table 3-1. FIND Command Relational Operators 



multiple 
values 
may be 
used 




OPERATOR 



IS 
IE 
EQ 



ISMOT 

INE 

IME 

<> 

ILT 
LT 

< 

INLT 
GE 

> = 

IGT 
GT 

> 

INGT 
LE 

< = 



MEANING 



is equal to 



is not equal to 



is less than 



is not less than (is greater than or equal to) 



is greater than 



is not greater than (is less than or equal to) 



IB value ^ ,value2 is between (and including) value.^ and value2 

The >=,< = ,<> operators cannot have any intervening spaces. 



U AND X TYPE VALUES 

When entering values for U and X type data items, the values must appear exactly as the data 
was entered originally. For example, if the data item STREET-ADDRESS has a value with 
three spaces between the street number and name, you must enter those spaces or QUERY 
will not find the item. Leading blanks must also be entered if they appear in the item. Since 
blanks or spaces are special characters, all such values must be enclosed in quotes. 

LOGICAL CONNECTORS 

To make more than one comparison for each entry selected, you connect relations with the 
logical connector AND or OR. The AND connector instructs QUERY to select only those 
entries whose data item values satisfy both relations on either side of the AND. The OR 
connector indicates that entries are selected if one or the other (or both) of the two relation- 
ships on either side of the OR is satisfied. 
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Both types of logical connectors can appear in a FIND command. All relations connected 
with AND are examined as if they were surrounded by parentheses. Any relation or set of 
relations separated from others by OR are compared to the data entry and the entry is 
selected if the relations are true. For example, the command: 

FIND A = 3 AND B = 4 OR C IGT 9 END 

locates all entries with both A equal to 3 and B equal to 4 as well as all entries containing a 
C value greater than 9. The command: 

FIND A = 3 OR A = 2 AND B = 5 AND C = 8 OR B = 9 END 

locates all entries with either A equal to 3, A equal to 2 and B equal to 5 and C equal to 8, 
or entries with B equal to 9. 

Parentheses cannot be used in a command, but you can create constructs which act as paren- 
theses and force an OR comparison to take precedence over an AND comparison. For example, 
if Cn stands for a relation, 

(C-^ ORCg) AND Cg 
is represented as: 

Cj^ AND Cg OR AND Cg 
Up to 50 logical connectors may be used in one FIND command. 

MULTIPLE VALUES 

To specify more than one value for the same data item, list the values one after the other, 
separated by commas. For example, the command: 

FIND STATE IS "CALIFORNIA", "NEVADA", "WASHINGTON" END 

locates entries with the value of data item STATE equal to either C ALIFORNIA,NEVADA, 
or WASHINGTON. The above command is equivalent to: 

FIND STATE IS "CALIFORNIA" OR STATE IS "NEVADA" OR STATE IS "WASHINGTON" END 
Multiple values may be used only with the "equal" or "not equal" relational operators. 



3-5 



FIND 



USING NULL VALUES 

A FIND command can be entered which prompts you for data item values to be compared 
with data item values in data entries of the data set. To do this, you merely use null data item 
values in the command. Null values are represented by a pair of quote marks without any 
intervening characters or blank spaces (""). When the command is executed, you are prompted 
to enter a value for each null value in the command. This is useful when the FIND command 
is stored as a procedure on the Proc-file. (See Section V for more information about 
procedures.) 

The procedure can be executed using different comparison values vdthout modifying the 
procedure each time. For example, the command: 

> FIND SALES.ACCOUNT # "" END 

would prompt you for a value of ACCOUNT with the message: 

WHAT IS THE VALUE OF - ACCOUNT 

» 24536173 

USING SERIAL READ 

10 ENTRIES QUALIFIED 

QUERY searches the appropriate data set for the value you specify. The value should be 
entered without surrounding quotes since all characters entered (including leading blanks, 
quotes, and other special characters) are significant. The maximum value size is 72 characters. 

You are prompted once for each null value in the command. For example, the command: 

> FIND CUSTOMER. CITY IS END 

prompts you twice for the value of CITY as follows : 

WHAT IS THE VALUE OF - CITY 
» PETALUMA 

WHAT IS THE VALUE OF - CITY 
» ALVISO 

USING SERIAL READ 

2 ENTRIES QUALIFIED 

Lowercase characters are upshifted unless the data item type is X. 

In session mode, supply the desired value after each prompt message. In job mode, you must 
anticipate the order of prompts and supply the desired values, one per record, following the 
FIND command. 



3-6 



FIND 

EXAMPLES 



> FIND LAST-NAME IS MARTENSEN END 

USING SERIAL READ 

0 ENTRIES QUALIFIED 



To determine whether or not a 
customer is already in the data set, 
you can try to find their name. 



CUSTOMER. ACCOUNT EQ 24536173 



>FIND 

1 ENTRIES QUALIFIED 

>FIND ACCOUNT 



EQ 24536173 



IS A MEMBER OF THESE 



ACCOUNT 
CUSTOMER^ SALES 

WHICH SET DO YOU WISH TO USE? 
» SALES 

3 ENTRIES QUALIFIED 



Since account is in more than one 
data set you can either qualify the 
data item name or let QUERY 
prompt for it. 
SETS: 

SALES is automatically entered in 
the data set list. 



In the example below, QUERY uses the data set list to determine which of the three data sets 
containing STOCK# to use. Since SALES was placed in the data set list in the previous 
example, it is used. However, the data item DESCRIPTION is in the PRODUCT data set and 
a FIND command can only refer to one data set so an error results. It is usually best to clear 
the data set list if you are unsure about what it contains. 



> F STOCK# IGT 33333333 AND DESCRIPTION 
RETRIEVAL FROM MORE THAN ONE DATA SET 



IS "NEHRU JACK ET " 



Clear the data set list. 

IGT 33333333 AND DESCRIPTION IS "NEHRU JACKET" 
IS A MEMBER OF THESE SETS: 



>S=^ 

> F STOCK# 
STOCK# 

PRODUCT., SALES., INVENTORY 
WHICH SET DO YOU WISH TO USE? 
» PRODUCT 
USING SERIAL READ 
0 ENTRIES QUALIFIED 

>F STOCK# IGT 33333333 AND DESCRIPTION IS "NEHRU JACKET" 



Now QUER Y prompts for the 
data set. 



USING SERIAL READ 

0 ENTRIES QUALIFIED 



PRODUCT was entered in the data 
set list.automatically as a result 
of the previous command so 
QUER Y uses PRODUCT and does 
not prompt for the data set name. 
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>F ACCOUNT IGT 55555555 AND STATE IS CA OR ACCOUNT IS 12121212& 
» AND STATE I S MA OR CUSTOMER. STATE IS AZ 
ACCOUNT IS A MEMBER OF THESE SETS: 

CUSTOMER, SALES 

mien SET DO YOU WISH TO USE? 
>> CUSTOMER 

INVALID NUMERIC DIGIT This error occurs because an 

ampersand is used to continue the 
line but there is no space before 
it or at the beginning of the next 
line. 



>F CUSTOMER. ACCOUNT IGT 55555555 AND STATE IS CA OR ACCOUNT & 
» IS 121212 AND STATE I S MA OR STATE IS AZ 



STATE IS A MEMBER OF THESE SETS: 

CUSTOMER, SUP-MASTER 
WHICH SET DO YOU WISH TO USE? 
» CUSTOMER 
USING SERIAL READ 
6 ENTRIES QUALIFIED 
>R D, ACCOUNT, 10; D, STATE, 15; END 



All items which appear in 
multiple sets must be qualified 
unless the set name is in the set 
list. 



76623455 CA 

74001813 CA print the data 

87654321 CA 

80808080 CA 

77765555 CA 

99998877 CA 



After the entries are located you 
can use the REPORT command to 



> F CUSTOMER. ACCOUNT IGT 55555555 AND CUSTOMER . STATE IS CA OR & 
» ACCOUNT IS 12121212 AND STA TE IS MA OR STATE IS AZ 

STATE only needs to be qualified 
once. 



USING SERIAL READ 

6 ENTRIES QUALIFIED 



A simpler technique for determining the data set to be used is to enter it in the data set list 
with the DATA-SETS= command 

> S= CUSTOMER 

>F ACCOUNT IGT 55555555 AND STATE IS CA OR ACCOUNT IS 12121212 & 

» AND STATE IS MA OR STATE IS AZ 

USING SERIAL READ 

6 ENTRIES QUALIFIED 
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Locates all entries in the data set regardless of the value of the data item specified. 



The form of the FIND command when used for this purpose is 
( FIND ] 

I p I ALL [data set name.] data item name 



For example, 



FIND ALL LABOR.BADGE# 

data set name data item name 



or 



FI ALL F-NAME 

, . / 

data item name 

where data set name is the name of the data set you want to access. 

data item name is the name of any item in that set. 



If you want to locate all entries in a data set (and use these entries in a report, for example), 
this is an easy way to do so. 

If you do not specify a data set name, QUERY will check the data set list and follow the same 
rules as defined when using a FIND command with a single data set. (See the first form of 
the FIND command earlier in this section.) 

EXAMPLES 

> F ALL CUSTOMER. ACCOUNT 
USING SERIAL READ 
13 ENTRIES QUALIFIED 



All entries in the CUSTOMER data 
set are located. 



FIND procedure 



Executes a FIND procedure stored in the current Proc-file. 



The form of the FIND command when used for this purpose is 

find) 



procedure name [,character] 



For example, 



FIND PROCA 

\ 

procedure name 



or 



FI USERS,X 

procedure name character 

where procedure name is the name of a FIND command previously stored 

as a procedure using the CREATE command. The 
procedure must exist in the current Proc-file 
specified with the PROC-FILE= command or in 
response to the PROC-FILE prompt. 

character is any printable ASCII character. If character is 

included in the command, then the FIND procedure 
is listed. 



QUERY searches the current Proc-file (defined by a DEFINE or PROC-FILE) and executes 
the procedure named in the command. If the Proc-file has not been declared, or the procedure 
does not exist in the Proc-file. or the orocedure is incorrect in some wav. vou are informed bv 



FIND CHAIN 



Locates data entries from more than one data set. 



The form of the FIND command when used for this purpose is 

'IS 



I p I CHAIN item identifier \ 



'value " 



I OR j ^^^"^ 



■IS\ 

IE 

EQ 



"value" 



END 



For example, 



or 



item identifier 



FIND CHAIN EMPLOYEE.BADGE#,LABOR.BADGE# IE "1234" END 
master set name / detail set name \ value 



master search item 



detail search item 



FI CHAIN EMPLOYEE.BADGE#,LABOR.BADGE# IS 1234 OR & 
EMPLOYEE.BADGE#,LABOR.BADGE# IS 9018 END 



/ 



indicates command 
continues in next 
record 



master set name 



master search item 



detail set name 



detail search item 



where item identifier takes the form: 

master set name. master search item,detail set 
name.detail search item 

is the name of a master data set in the data base. 

is the name of a data item defined as the search 
item for the master data set. 

is the name of a detail data set that is related to 
the master data set previously named. 

is the name of a data item defined as a search 
item for the detail data set. This search item 
must provide the link between the detail set and 
the previously named master data set. 

value is a data item value. It must be the same type 

and within the same value range as the data items 
master search item and detail search item. Value 
must be enclosed in quotes only if it contains 
special characters or blanks. 

Only one detail data set can be accessed using a FIND CHAIN command but multiple master 
sets may be used if they relate to the same detail set through search items. 
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The data base administrator can provide you with the information required to use this command 
or you can use the FORM command to determine the data item and data set relations. 

When you enter FIND CHAIN, QUERY searches the specified master data sets for an entry 
containing the specified search item value. Then QUERY searches the specified detail data 
set for entries containing the same search item value. Detail entries with the same search item 
value are called chains. The effect of FIND CHAIN is to locate all the members of a detail 
chain and the master data entry which constitutes the chain head. For more information 
about chains, chain heads, and data set relations, consult the IMAGE/3000 Reference Manual 
(see Preface for part number). 

Remember, when using FIND CHAIN: 

• Only selection on the basis of equality can be made. Relational operators other than 
IS, IE, EQ, and = are not allowed. 

• Only one value per relational operator is allowed. 

• Data items named in the command must always be search items (as defined in the data 
base schema). 

• Multiple logical connectors (AND, OR) can appear in the same command. The rules for 
determining which entries are described with the FIND command. 

EXAMPLES 

>FIND CHAIN CUSTOMER. ACCOUNT, SALES. ACCOUNT IS 7 662 345 5.. 24536 1 7 3 & 
» AND PRODUCT. STOCK#, SALES. STOCKiy IGT 22222222 OR & V 
» CUSTOMER. ACCOUNT, SALES. ACCOUNT ILT 55555555 END \ 
INVALID # OF VALUES FOR RELATIONAL OPERATOR \ 

Only one value is allowed per 

relation. 



> FIND CHAIN CUSTOMER. ACCOUNT, SALES. ACCOUNT IS 76623455 AND & 

» PRODUCT.STOCK#, SALES. STOCK# IGT 22222222 OR & 

» CUSTOMER. ACCOUNT, SALES. ACCOUNT ^ILT 55555555 END 
INVALID RELATIONAL OPERATOR 



Only "equal" relational operators 
are allowed. 
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In the example below, CUSTOMER is searched for an entry containing ACCOUNT equal to 
76623455 and one entry is found. Then PRODUCT is searched for an entry containing 
STOCK# equal to 6550D22S, one entry is found. SALES is searched for entries with both 
ACCOUNT equal to 76623455 and STOCK* equal to 6550D22S but no entries are located. 
CUSTOMER is searched for entries containing ACCOUNT equal to 54283545 and SALES is 
searched for entries containing ACCOUNT equal to 54283545. One entry is found for each 
relation. 

> FIND CHAIN CUSTOMER. ACCOUNT, SALES. ACCOUNT IS 76623455 AND & 
» PHODUCT. STOCK#.> SALES. STOCK# IS 65500225 OR & 
» CUSTOMER. ACCOUNT, SALES. ACCOUNT IS 54283545 END 
4 ENTRIES QUALIFIED „ , , ... 



>R ALL 



Four entries were located which 
satisfied the relations. The REPORT 
ALL command prints the content of 
the entries. 



ACCOUNT 
LAST-NAME 
FIRST-NAME 
INITIAL 

STREET-ADDRESS 

CITY 

STATE 

ZIP 

CREDIT- RATING 




CUSTOMER data setentry. (Satisfies 
CUSTOMER. ACCOUNT IS 76623455). 



STOCK# 
DESCRIPTION 



= 6550D22S 

= BASEBALL BAT 



-PRODUCT data set entry. (Satisfies 
PRODUCT. STOCK#IS 6550D22S). 



ACCOUNT 
LAST-NAME 
FIRST-NAME 
INITIAL 

STREET-ADDRESS 

CITY 

STATE 

ZIP 

CREDIT-RATING 



=54283545 
=M AY FIELD 
=WILLIAM 




CUSTOMER data set entry. (Satisfies 
CUSTOMER. A CCO UNT IS 
54283545). 



=39 41ST AVE. 

=PETALUMA 

= GA 

=10101 

= 8.50000 




SALES data set entry. (Satisfies 
SALES. ACCOUNT IS 54283545). 



ACCOUNT 

STOCK# 

QUANTITY 

PRICE 

TAX 

TOTAL 

PUR CH- DATE 
DEL IV- DATE 



=4397D13P 
= 1 

= 4590 
= 276 
= 0 

=121575 
=122075 



> 



Note that ACCOUNT and STOCK# are both search items. 
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Adds data entries to a manual master or detail data set. 



The form of the UPDATE ADD command is 




UPDATE ADD, 




- 


U ADD, 
ADD [,] 

Ud [,] J 


data set name 



For example, 

UPDATE ADD, LABOR 

data set name- 



or 



AD, PAYROLL 

t 

data set name 



where 



data set name 



is the name of a data set in the data base. The data 
set must be either a manual master or detail, and 
you must have write access as determined by your 
response to the PASSWORD=> > prompt when 
the data base was last specified or use of the 
PASSWORD= command. 



When you use the UPDATE ADD command, QUERY prompts you for data item values by 
printing the names of the data items. You type the desired value following the data item 
name. For example. 



>AD PRODUCT 
STOCK # 
DESCRIPTION 



=>> 123^5678 
=>>"ANTIMACASSAR' 



STOCK # 
STOCK # 
DESCRIPTION 



= >> return 
=>> 5A231g34 
= >> return 



Values must be provided for search 
items. 



STOCK* 
> 



= >>// 



Two slashes terminate the command. 



If a value contains invalid characters, QUERY issues a message and reprompts for the same 
data item name. Character type values are truncated if too long. 
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USING QUOTE MARKS 

Values may be entered with or without bracketing quote marks. When you enter a U or X type 
value without quotes, leading blanks are ignored and the value is left-justified in the data 
item field. Blanks or any other special characters are entered in the data field only if the 
value is entered with quotes. For example, 

F-NAME» SALLY 



is entered in an 8-character field as: [S|A|L|L[Y| | | | and 

F-NAME»" SALLY" 



is entered in the same field as: S A 



L L 



A U type data item is automatically upshifted if entered in lower case. You can override 
the upshifting by enclosing the entry in quotes. For example, if F-NAME is a U type data 
value, 

F-NAME>>sally is entered as SALLY 

but, 

F-NAME>>"sally" is entered as sally 

If quote marks are to be included as part of the value, they must be entered twice to avoid 
confusion as delimiters. For example, the value: 

ROBERT "BOB" BRUN 

must be entered as: 

"ROBERT ""BOB"" BRUN" 

The value must also be surrounded by quotes in this case. 

Numeric type values (all types except U and X) are always right-justified whether entered 
with or without quotes. Numbers entered in X type data items are left-justified just as 
other character type values. 

NULL VALUES 

Only search and sort items must have values supplied. If you do not want to enter a value 
for other items you may enter a null value. In session mode, press return without any pre- 
ceding characters. In job mode supply a blank record to indicate a null value. Numeric data 
items which do not contain a value are set to zero, character items are set to blanks. 



MAY 1979 
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Real number values can be entered either as fixed or floating point numbers. An example of 
a fixed-point number is: 

23.45 

while an example of a floating-point number is: 
2.345E+01 

The signed integer following the E stands for a power of 10 to be multiplied by the number 
to the left of the E. Both examples above stand for the same number. 



MAY 1979 
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DETAIL DATA SETS 

If a detail data set is linked to one or more manual master data sets, you must know the 
content of the master data set before you can add entries to the detail data set. Each detail 
entry is associated with a master entry through a search item. The detail search item and 
the master search item must have the same value and the value must exist in a master entry 
before you can add it to a detail entry. If you enter a search item value that does not exist 
in the master data set linked to the detail through that item, QUERY prints the message: 

MISSING CHAIN HEAD FOR data item name / data set name 

and does not place the entry in the data set. For example: 



> AD INVENTORY 

STOCK# 

ONHANDQTY 

SUPPL I ER 

WIT-COST 

LASTSHIPDATE 

BINNUM 

MISSING CHAIN 



detail set 



=>> 9999A99A 

=>>287 

= >> XXXXXX ^ 

= >>1_455 

=>>121875 



search item 



= >>9 
HEAD "for 



SUPPL I ER/SUP-MASTER 



There is no SUPPLIER value XXXXXX in the SUP-MASTER data set. You must add an 
entry to SUP-MASTER giving XXXXXX as the value for the data item named SUPPLIER. 
Then you will be allowed to add the same value to the detail set named INVENTORY. 

TERMINATING UPDATE ADD 

Once you have supplied values (null or otherwise) for all the data items in the entry, QUERY 
begins prompting you for another entry. To continue adding entries, merely enter an appro- 
priate value for the prompt. To terminate the UPDATE ADD command, either enter two 
slashes (/ /) followed by return or enter Control Y (Y^). (Control Y is entered by pressing 
and holding the control key and then striking Y.) 

The command can be terminated at any time you are prompted for a value. However, unless 
you want to discard the values you have entered for the current entry, you should not use Y^ 
or two slashes before you have been prompted for the last value of the current entry. In 
other words, you normally terminate the command in response to the first data item prompt 
in an entry. 
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EXAMPLES 



>UPDATE ADD, PRODUCT 



STOCK# 

INPUT TOO LONG 
DESCRIPTION 



=>> 9898989898 
■ TRLTNGATED 
= >> return 



You need not enter a value if the 
item is not a search item. 



STOCK# 
DESCRIPTION 



=>> 78787878 
=>>SQUIRREL CAGE 



STOCK # 



= >>// 



>UPDATE ADD, SALES 



ACCOUNT 

STOCK* 

QUANTITY 

PRICE 

TAX 

TOTAL 

PUR CH- DATE 
DEL IV- DATE 



=>> 80808080 
=>> 78787878 
= >>6^ 
=>>2000 



= >> return 
= >> return 
=>> 12I575 
=>>121675 



Terminate command with / /. 



An attempt is made to enter an 
account which is not in the 
CUSTOMER master data set. 



MISSING CHAIN HEAD FOR ACCOUNT/CUSTOMER 



QUER Y prints an error 



ACCOUNT =>>/_/ 
>UPDATE ADD, CUSTOMER 



ACCOUNT 
LAST-NAME 
FIRST-NAME 
INITIAL 

STREET-ADDRESS 

CITY 

STATE 

ZIP 

CREDIT-RATING 



=>> 80808080 
=>> CELERY 
=>> ALLISON 
= >> B« 

=>> 18 ASCOT AVE. 

=>>CARMEL 

= >>CA 

=>>93921 



Terminate the command and add 
the account to the master data set. 



= >> 1.2 



ACCOUNT 



= >>// 



>UPDATE ADD, SALES 



ACCOUNT 

STOCK # 

QUANTITY 

PRICE 

TAX 

TOTAL 

PUR CH- DATE 
DEL IV- DATE 



=>> 80808080 
=>>78787878 
= >>6 
=>> 2000 
= >> return 
= >> return 
= >> 121575 . 
=>> 121675. 



ACCOUNT 
> 



= >>// 



Terminate the command and now 
add the original entry to the SALES 
detail set. 



Note: These dates are automatically 
added to the automatic master data 
set named DATE-MASTER if they 
are not already in it. 
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Deletes data entries from a data set. 



The form of the UPDATE DELETE command is 




' UPDATE DELETE > 






U DELETE 




• 


DELETE 


1 




, DEL 





For example, 

UPDATE DELETE 

or 

DELETE 



This command is an extension of the FIND command in that it deletes those entries selected 
by the previous FIND. All of the entries must reside in the same data set. Entering FIND 
CHAIN (selecting entries from more than one data set) and then UPDATE DELETE is not 
allowed. 



SECURITY PROVISIONS 

To delete entries from a data set, you must possess write access to the data set, as determined 
by the password you enter in response to the latest PASSWORD= prompt or through the 
latest use of the PASSWORD= command. 

When you enter an UPDATE DELETE command, QUERY prints the message: 

DELETE ALL RETRIEVED ENTRIES (YES OR NO)? 
» 

The message reminds you that all the entries selected by the last FIND will be deleted by the 
command. If you respond YES, QUERY deletes the entries. If you respond NO, the 
command is ignored and you are prompted for emother command. The message is not 
printed in job mode. 

MASTER DATA SET ENTRIES 

QUERY disallows any attempt to delete the master entry if its search item value still exists 
in the search items of the appropriately linked detail data sets. 
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EXAMPLES 



> F CUSTOMER. ACC0UNT=88888888.> 11111111 

2 ENTRIES QUALIFIED 

> DEL 

DELETE ALL RETRIEVED ENTRIES (YES OR NO)? The CUSTOMER entries with 

» YES ACCOUNT equal to 88888888 

> or 11111111 are deleted. 



> F CUSTOMER* ACCOUNT IS 80808080 
1 ENTRIES QUALIFIED 
> UPDATE DELETE 

DELETE ALL RETRIEVED EMfTRIES (YES OR NO)? 
»YES 

ATTEMPTED DELETION OF CHAIN HEAD 



In this example, there is still 
a detail data entry in SALES 
with an ACCOUNT value of 
80808080 so QUERY will 
not delete the entry from 
the CUSTOMER master data 
set. 



>F CHAIN CUSTOMER. ACCOUNT, SALES. ACCOUNT IS 80808080 END 



2 ENTRIES QUALIFIED 

> UPDATE DELETE 

UPDATE TO MORE THAN ONE SET 

>FIND SALES. ACCOUNT IS 80808080 END 



1 ENTRIES QUALIFIED 
> UPDATE DELETE 
DELETE ALL RETRIEVED 
»YES 



ENTRIES (YES OR NO)? 



FIND CHAIN is not allowed 
for deleting entries. 



An entry with ACCOUNT 
equal to 80808080 is deleted 
from the SALES detail data 
set. 
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Modifies the values of data items. 



The form of the UPDATE REPLACE command is 



UPDATE REPLACE 
U REPLACE 
REPLACE 
REPL 



,data item name = "value"; [data item name="value";. . .] END 



For example, 



UPDATE REPLACE, DATE="741010"; END 

/ \ 

data item name value 



or 



REPLACE, 
DATE="741010"; 
HOURS="4"; 
END 



where data item name is the name of the data item contained in the 

entries selected by the last FIND command. 



value is the new value for the data item surrovinded by 

quotes. It must be the proper size and type for 
the named item. Quotes are required. Type U, 
X, Z, and P values are tnmcated if too large, 
QUERY prints an error for other values of 
improper size or type. 



UPDATE REPLACE is an extension of the FIND command in that it operates on all data 
entries selected by the previous FIND command. All of the data entries selected must be 
from the same set. Entering a FIND CHAIN command (which selects entries from a detail 
and one or more master data sets) followed by an UPDATE REPLACE command is not 
allowed. 



QUERY does not allow you to modify data items defined in the data base as search or sort 
items. 



The UPDATE REPLACE command consists of a series of data item name/data item value 
pairs separated by semicolons. When the command is entered, QUERY replaces the value of 
each data item named in the command with the new value enclosed in quotes. The names of 
data items appearing in the command must belong to the data entries selected by the last 
FIND command. 
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SESSION MODE 

When you enter an UPDATE REPLACE command from a terminal, QUERY checks each line 
of the command as it is entered. If an error occurs, the line is ignored, an error message is 
sent, and you are prompted for another line. QUERY continues to prompt for lines until 
you enter END. END is required. 

The replacement statements (data item name/value pairs) may be entered on one line: 

>UPDATE REPLACE.. DATE= "74101 0"; H0URS="4"; END 
or on several lines: 



JOB MODE 

If you are entering the command in job mode, the replacement statements may appear in 
one record or several consecutive records. 

NULL VALUES 

You may store an UPDATE REPLACE command as a procedure with null values for the 
data items. You do this by entering a pair of quotation marks with no intervening charac- 
ters after data item name= (for example, DATE=" "). 

When such a procedure is executed using the UPDATE procedure name command, QUERY 
prompts you for a value by printing the message: 

WHAT IS THE VALUE OF data item name 
» 

where data item name is the name of the data item associated with the null value in the 
UPDATE REPLACE command. The desired value must be entered without quotes. All 
characters entered (including blanks, quotes, and other special characters) are significant. 
The maximum number of characters which may be entered as a value is 72. Lowercase 
characters are upshifted unless the data item is type X. 



> UPDATE REPLACE.. 
» DATE="741010"; 
» H0URS="4"J 
»END 



Note: An & is not required here to 
continue the command in the 
next record. 



> 
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EXAMPLES 



> F CUSTOMER. FIRST-NAME=GENEVA ^, 

USING SERIAL READ CUSTOMER entry with 

1 ENTRIES QUALIFIED FIRST-NAME of GENEVA is 

>REPLj STREET-ADDRESS="8 68 DOYLE ROAD" located. The street address is 

>7mD ■ changed. 

> UPDATE REPLACE., FIRST-NAME="GINGER"; INITIAL = "K"; END 

> LIST CUSTOMER FOR FIRST-NAME=GENEVA Then the first 

name and initial 
are replaced. 

>LIST CUSTOMER FOR FIRST-NAME=G INGER mu r rc^rr ^ u ^ 
The LIST command can be used 

to check the results. 

ACCOUNT LAST-NAME FIRST-NAME IN STREET- ADDRESS 

10034765 SLATER GINGER K 868 DOYLE ROAD 



> AD SALES 

ACCOUNT 

STOCK# 

QUANTITY 

PRICE 

TAX 

TOTAL 

PUR CH- DATE 
DEL IV- DATE 



=>> 80808080 
=>> 78787878 
= >>6 
=>> 2000 
= > > return 



= >> return 
=>> 121575 
=>> 121 675 



No values are entered for TAX and 
TOTAL when this entry is added. 



ACCOUNT 



= >>// 



>UPDATE REPLACE>TAX=25; TOTAL=2025; END 
RECORD HAS NOT YET BEEN FOUND 
>F SALES. ACCOUNT IS 80808080 
1 



ENTRIES QUALIFIED 
> UPDATE REPLACE.. TAX= "25"; TOTAL= "2025"; END 
OR 

> UPDATE REPLACE, 
»TAX="25" 



You can use the UPDATE 
REPLACE command to add 
these values later . . . but first 
you must locate the entry. with 
the FIND command 



» TOTAL="2025" 
»END 
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EXAMPLES 

> FIND PRODUCT. STOCK# IGT 70000000 

USING SERIAL READ 

3 ENTRIES QUALIFIED 

> UPDATE REPLACE.> 

» DESCRIPTION=OBSOLETE 

EXPECTED A LITERAL VALUE Values must be enclosed in quotes. 

» DESCRIPTI ON="QBSOLETE" 

»END 



> REPORT ALL You can use REPORT ALL to verify the 



STOCK* 
DESCRIPTION 



=7391Z22F 
=OBSOLETE 



replacements. The entries are still avail- 
able from the last FIND. Each PRODUCT 
data set entry with STOCK# equal to 
70000000 is changed so that the descrip- 
tion is OBSOLETE. 



STOCKf 
DESCRIPTION 



=78787878 
=OBSOLETE 



STOCK # 
DESCRIPTION 



=98989898 
=OBSOLETE 
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UPDATE procedure 



Executes an UPDATE command stored as a procedure in the current Proc-file. 



The form of the UPDATE procedure command is 
(UPDATE) 



I 



procedure name [,character] 



For example, 



UPDATE PROCX 

t 

procedure name 



or 



UP CHANGE, % 
where procedure name 



character 



is the name of an UPDATE ADD, UPDATE 
REPLACE, or UPDATE DELETE command 
procedure in the current Proc-file. 

is any printing ASCII character. 



You can use the CREATE command to store any of the three forms of the UPDATE command. 
Once the procedure is stored in the Proc-file, you use this form of the UPDATE command to 
execute it. Instructions for creating a command procedure are given in Section V. The 
UPDATE ADD, UPDATE REPLACE, and UPDATE DELETE command forms are described 
in this section. 



If you use an UPDATE procedure using the UPDATE procedure name form of the command, 
QUERY first checks each line of the procedure. If an error occurs, a message is sent and the 
incorrect statement in the line is ignored. All other correct statements in the procedure are 
executed. If the character is included in the command, the procedure is listed before execution 
begins. 



EXAMPLES 

> F LAS T - NAME IS MAYFIELD 

USING SERIAL READ 

1 ENTRIES QUALIFIED 

>PROC-FILE=PROCX 

> UPDATE CHANGE 

WHAT IS THE VALUE OF CITY 

» PETALUMA 

WHAT IS THE VALUE OF STREET-ADDRESS 
» 37 41 ST AVE. 

WHAT IS THE VALUE OF CREDI T- RATING 
»8.5 



Locate the entry to be updated. 

The procedure named CHANGE (located 
in Proc-file PROCX) contains: 

U REPLACE, 

CITY=" 

STREET-ADDRESS=" "; 

CREDIT-RATING=" 

END 

QUERY prompts for values when the 
procedure is executed. 
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> FIND F101 

WHAT IS THE VALUE OF - ACCOUNT 
» i 1 1 1 1 1 1 1 
NO ENTRY 

NO ENTRY 



The Fl 01 procedure contains: 
FIND CHAIN 

CUSTOMER.ACCOUNT,SALES. 

ACCOUNT 
IS " "END 



0 ENTRIES QUALIFIED 
> FIND F101 

WHAT IS THE VALUE OF - ACCOUNT 

» 54283545^ 

2 ENTRIES QUALIFIED 

>R ALL^Z 



QUERY prompts for the value of 
ACCOUNT. 

The REPORT ALL command prints 
the entry data. 



54283545 
MAYFI ELD 
WILLIAM 

37 4 1ST AVE. 
PETAL UMA 
GA 

10101 
8.50000 



54283545 
4397D13P 
1 

•4590 

276 

0 

121575 
122075 



CUSTOMER master data set entry. 



SALES detail data set entry. 
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QUERY provides several reporting techniques which enable you to examine the data base 
content without writing programs. The techniques are based on various forms of the LIST 
and REPORT commands which are described in this section. 

The LIST command provides automatic formatting including column alignment and headings. 
The functions of selectively locating and reporting on entries are combined in a single 
command. 

REPORT ALL, one form of the REPORT command, is similar to the LIST command since 
you do not specify a format. However, REPORT ALL prints all data item values in each 
entry located with the last FIND command. QUERY prints data item name and value pairs, 
one item per line, for each data item in each entry located. 

If you want to design your own report format, you can use another form of the REPORT 
command which allows you to produce reports which include : 

• From 1 to 9 lines of heading information such as a title, column headings, page numbers, 
date and time of day at the top of each report page. (You may also have blank lines 
interspersed in the heading but the heading cannot exceed one page.) 

• Sorted entries with group (or subset) and total information printed with entries belong- 
ing to the same group. (You can accumulate totals, compute averages, and count 
entries automatically or use the ten QUERY registers to do other computations on 
numeric data item values and report the results.) 

• Edited data item values with inserted dollar signs, minus signs, decimal points, and 
other ASCII characters. (You may also suppress leading zeros.) 

You can include statements in your report which change the output device to the QSLIST 
device, define the number of lines per page, request a pause after each page is printed in 
session mode, and suppress the margins which normally appear at the top and bottom of a 
page (for example, information on a line printer can be printed across the perforation). 

REPORT commands may be stored as command procedures. 



SECTION 



IV 
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LIST 



Prints complete or partial entries from a single data set with automatic formatting and 
headings. 



The form of the LIST command is 

FOR relation 



LIST 1 I data set name 
L / ( data item list 



/ AND) , . 

I OR I ^^lotion 



] [end] 



For example, 



or 



LIST LABOR FOR BADGE* IE "09.18" AND F-NAME IE JOE 
data set name relation relation 



LIST BADGE#,F-NAME,L-NAME 



data item list 



or 



LI LABOR 

, t 

data set name 



where 



data set name 



is the name of a data set in the current data base. 



data item list 



is a list of data item names separated by commas. 
All the data items must be from the same data 
set. You can list them in any order. A data item 
name may not be qualified with a data set name. 



relation takes the form: 



data set name, data item name relop "value", 
"value".. . 



data item name is the name of a data item contained in the data 

set. If you use data set name instead of data item 
list preceding the FOR, you should not qualify 
any data item names with data set names. If you 
precede the FOR with a data item list, you can 
qualify the data item in the first relation with a 
data set name. 
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relop is a relational operator as shown in table 4-1 . 

value is a data item value. It must be the same type 

and within the same value range as the data item 
named in the relation. Value need not be 
enclosed in quote marks (") unless the value 
contains special characters. Values which are 
not contained in quotes are upshifted, for 
example, California is converted to CALIFORNIA 
before it is compared to data item values in the 
data base. 



Table 4-1. LIST Command Relational Operators 



OPERATOR MEANING 



is equal to 



Multiple values may be 
used with these operators. 



is not equal to 



is less than 



is not less than (is greater than or equal to) 



is greater than 



is not greater than (is less than or equal to) 



IB value value2 is between (and including) value ^ and value2 

The operators <>, <=, >= cannot have any intervening spaces (embedded blanks). 
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The maximum number of logical connectors (AND, OR) which can be used in the LIST 
command is 10. 

The LIST command prints all or a subset of the data item values from a single data set. It 
is one of the simplest ways to report on your data since you do not need to design a report 
or specify the format and headings. 

LISTING FORMAT 

The data is printed in columns. The width of a column (or field) is determined by the data 
item type. Table 4-2 summarizes field widths. QUERY provides two spaces between fields. 

Data item names are printed as column headings at the top of each page. If the complete 
data item name is longer than the field width, it is truncated. Headings of character type 
data items are left-justified and numeric type items are right-justified. 

If all of the data you request does not fit on one line (in one record), data items at the end 
of the data item list or the data entry are ignored. The line length varies with the device you 
Eire using. It is usually 72 to 80 characters for a terminal and a maximum of 136 characters 
for a line printer. 



Table 4-2. Field Widths 



ITEM TYPE 


FIELD SIZE (in characters) 


11 


6 




12 


11 




J1 


5 




J2 


10 




K1 


5 




R2 


12 




R3 


17 




Zn 


n+1 


(maximum=20) 


Pn 






U/7 


n 


. (maximum=line length)* 


Xn 


n 




'Absolute maximum= 


136, the line length for a line printer. 
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LISTING A SUBSET OF THE DATA 

You may list a subset of the data set values in two ways: 

• Use the data item list form of the command to specify particular items you want to 
list. For example, 

LIST F-NAME, L-NAME, YROFSERV 

lists the values of F-NAME, L-NAME, and YROFSERV for each entry in the set. 
This form is useful if the complete data entry does not fit on one line. You can 
change the order of the data items and print the last ones in the data entry first or 
print only the last items. 

• Use the FOR parameter to set criteria for selection of entries from the set. For 
example, 

LIST LABOR FOR YROFSERV GE 5 

lists the value of all data items in each entry of the LABOR data set containing 
YROFSERV values greater than or equal to 5. 

It is also possible to combine these techniques. For example, 

LIST F-NAME, L-NAME FOR YROFSERV GE 5 

lists the full names of each person entered in the set whose years of service (YROFSERV) 
total is greater than or equal to 5. Note that the data item used as selection criteria need 
not be in the data item list. 
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DETERMINING THE DATA SET TO BE LISTED 

If you use the LIST command form specifying a data set name, there is no ambiguity as 
to which information will be listed. If you use a data item list, you should consider the 
following: 

• If the command has a FOR clause, QUERY uses the data item in the first relation 
to determine the data set to be listed. 

• If there is no FOR clause, it uses the last item in the data item list. 

In either case, if the data item appears in only one data set, that set (or a subset of it) is 
listed. If it appears in more than one set and is qualified, the named data set is listed. 
Otherwise, QUERY uses the data set list and follows the rule described with the 
DATA-SET= command. (See Section II.) 



THE RELATION OF LIST AND FIND 



The entries selected by the LIST command are not available for any other purpose except 
the output of this command. The entries selected by the most recent FIND command are 
unaffected by LIST and are still available for use with the UPDATE and REPORT 
commands. 



EXAMPLES 

In the example below QUERY could not locate the required entry until the value was 
entered with the correct spacing. 



>L CUSTOMER FOR STREET-ADDRESS=" 868 DOYLE ROAD" 

>L CUSTOMER FOR STREET- ADDRESS^ "8 68 DOYLE ROAD" 

ACCOUNT LAST-NAME FIRST-NAME IN STREET- ADDRESS 

10034765 SLATER GINGER K 868 DOYLE ROAD 



4-6 



LIST 



In the next two examples, the data item values for INVENTORY and SALES entries with 
STOCK# equal to 6650D22S are listed. 



>L INVENTORY FOR STOCK* =6650D22S 



STOCK# 


ONHANDQTY 


SUPPLIER 


UNIT-COS 


LASTSH 


BIN 


66 50 D22S 


5306 


ACME WIDGET 


1427 


1 20375 


3 


6650D22S 


600 


HEWLETT-PACKARD 


12500 


1 11575 


3 


6650D22S 


3 


H & S SURPLUS 


0 


121575 


0 


6650D22S 


999 


Has SURPLUS 


1 500 


120575 


0 


6650D22S 


13 


H & S SURPLUS 


M45 


121475 


3 


66 5 0 D22S 


1 1 


H & S SURPLUS 


1395 


121 575 


3 


6650D22S 


3 


H & S SURPLUS 


0 


121575 


0 


6650D22S 


1 I 


H & S SURPLUS 


139 5 


121575 


3 



>L SALES FOR STOCK#= 6650D22S 



ACCOUNT STOCK* 



QUANT I 



PRICE 



TAX 



TOTAL PURCH- 



24536173 
24566356 



6650D22S 
6650D22S 



3 
1 



598 
12500 



>LIST CUSTOMER FOR ACCOUNT GT 55555555 



20 
750 

List CUSTOMER entries with 
ACCOUNT greater than 



0 
0 



1 20875 
121575 









55555555. 


ACCOUNT 


LAST- NAME 


FIRST-NAME 


IN 


STREET-ADDRESS 


76623455 


MCFALL 


JEFF-REY 


X 


6650 MONTEREY ROAD 


7400181 3 


FI ELD 


HUBERT 


J 


4556 GEARY 


87654321 


JONES 


JOHN 


P 


1 PINE AVE 


80808080 


CELERY 


ALL I SON 


B. 


18 ASCOT AVE. 


77765555 


PALMER 


ERNEST 


M 


3728 CHECKERS COURT 


99998877 


MEADOWS 


JASPAR 


A 


5606 SUNNYHILLS DRIVE 
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>LIST LAST-NAME^ STREET- ADDRESS.> CITY, STATE FOR ACCOUNT GT 55555555 



ACCOUNT 

CUSTOMER, SALES 
WHICH SET DO YOU 
» CUSTOMER 



LAST-NAME 



IS A MEMBER OF THESE SETS; 



WISH TO USE? 



STREET-ADDRESS 



All values do not fit on the line 
so you can also list by data item 
name to get the items at the end 
of the entry. 

CITY 



ST 



MCFALL 
FI ELD 
JONES 
CELERY 
PALMER 



6650 MONTEREY ROAD 

4556 GEARY 

1 PINE AVE 

18 ASCOT AVE. 

3728 CHECKERS COURT 



C ARM EL 

CUPERTINO 

CAMPBELL 

CARMEL 

ALVISO 



CA 
CA 
CA 
CA 
CA 



>LIST STOCK# 

STOCK# IS A MEMBER OF 

PRODUCT, SALES, INVENTORY 
WHICH SET DO YOU WISH TO USE? 
» INVENTORY 



THESE SETS: 

INVENTORY is entered in the data set 
list. 



STOCK* 

6650D22S 
2457A1 IC 
3586T14Y 

< CONTROL Y > Control Y terminates the listing 

7391Z22F 
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>LIST STOCK# FOR QUANTITY IGT 2 AND ACCOUNT ILT 888^8888 



STOCK# 

6650D22S 
358 6T14Y 
5405T14F 
78 

< CONTROL Y > 
>LIST 5T0CK# 

STOCK# IS A MEMBER OF 

SALES, INVENTORY 

WHICH SET DO YOU WISH TO USE? 
» INVENTORY 



Since QUANTITY is in the SALES 
data set and is part of the first rela- 
tion, SALES data set STOCK# 
values are printed. 

SALES is automatically added to the 
data set list. 

THESE SETS: 

SALES and INVENTOR Y are both in 
the data set list so QUERY must prompt 
for which set you want. 



STOCK# 



6650D22S 
2457A1 1 C 
358 6T 1 4Y 
7391Z22F 
5405T14F 
6650D22S 
6650D22S 
7391Z22F 
5405T14F 
4397D1 3P 
37 39A14F 
66 50 D22S 
6650D22S 
6650D22S 
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REPORT ALL 



Prints data item values of entries located by the last FIND command without formatting- 



The form of the REPORT command when used for this purpose is 
[output control statements] ALL [,character] 



For example, 

REP ALL,X 

\ 

character 

or 

REPORT ALL 

where output control statements alter the standard output parameters. 

(See output control statements in this 
section.) 

character is any printable ASCII character. If 

included in the command, the data item 
names are omitted from the report. 
Otherwise, the data item name precedes 
each data item value. 



REPORT! 
R I 



Each form of the REPORT command is an extension of the FIND command in that it prints 
a report of the data entries located by the last FIND command. 

REPORT output can be directed to any desired output device through MPE :FILE commands 
and the QUERY OUTPUT command. Consult the description of OUTPUT for more information. 

When QUERY prints an unedited negative number, a special character in the rightmost digit 
substitutes for the minus sign. This special character varies according to the rightmost digit 
of the value. Table 4-3 shows which special characters are used to indicate negative numbers. 
For example, the number -104 is represented as lOM according to the table. If you are not 
using REPORT ALL, you may edit using REPORT command edit statements to print the 
data item value with a negative sign and the last digit from 0 to 9. 
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Table 4-3. Negative Number Representation 



UNITS DIGIT 



0 


1 


1 


J 


2 


K 


3 


L 


4 


M 


5 


N 


6 


0 


7 


P 


8 


Q 


9 


R 



NEGATIVE REPRESENTATION 

(may vary with the terminal used) 



EXAMPLES 
> REPORT ALL 

RECORD HAS NOT YET BEEN FOUND 

> FIND ALL LAST-NAME 

USING SERIAL READ 

13 ENTRIES QUALIFIED 

>REPORT ALL 



If you use REPORT ALL and you 
have not located any entries 
previously, QUERY prints an error 
message. 

Once records have been found, 
REPORT ALL prints the value for 
each item to which you have access. 



ACCOUNT 
LAST-NAME 
FIRST-NAME 
INITIAL 

STREET-ADDRESS 

CITY 

STATE 

ZIP 

CREDIT-RATING 



=54283540 
^CORCORAN 
= CLIFFORD 
= C 

= 6105 VALLEY 
= CARMEL 
= CA 

=93921 

' 7.10000 



GREEN DR. 



ACCOUNT 

< CONTROL Y > 



^54 
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> REPORT ALLjX report all with a character prints the data 

item values without the data item names. 



54283540 
CORCORAN 
CLIFFORD 
C 

6105 VALLEY GREEN DR. 

CARMEL 

CA 

93921 
7. 10000 



542 8 3 5 4 5 
MAY FIELD 
WILLIAM 

37 4 1ST AVE. 

PETALUMA 
GA 

10101 
8. 50000 

You can terminate the report at any time by 
10293847 entering Control Y. 

< CONTROL Y > 
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Lists data item values of entries located by the FIND command in the format you specify. 



The form of the REPORT command is 

iREPORTl ^ ^ ^ 

\^ I report statements 



END 



For example, 
REPORT 

HI, "NAME LIST",20,SPACE A2- 

D,LAST-N AME,20 

D,FIRST-NAME,30-* 

END 



■ header statement 



=— detail statements 



or 



R HI, "NAME LIST", 20, SPACE A2;D,LAST-NAME,20;D,FIRST-NAME,30;END 
header statement^^ detail statements 



where 



report statements 



consist of a sequence of header, detail, sort, 
group, total, register, edit, and output control 
statements, as outlined in table 4-4. These 
statements are explained in detail later in this 
section. Statements can be entered on separate 
lines or on one line separated by semicolons. 



Table 4-4. REPORT Statements 



STATEMENT TYPE 


FUNCTION 


Header 


Prints title, column headings, page numbers, time of day, and the date at 
the top of each report page. 


Detail 


Prints data item values in the column position specified. 


Sort 


Sorts data entries based upon the value of a specified data item. 


Group 


Prints a data item value or character string whenever the value of an 
appropriate "sort item" changes. 


Total 


Prints column count, average, or totals for logical groups or entire report. 


Edit 


Describes edit masks used to punctuate Group, Detail, or Total fields. 


Register 


Specifies an operation to be executed in Register n. 


Lines = 


Specifies the number of lines per page. 


Nopage 


Suppresses page advancing. 


Out=LP 


Switch output device. 


Pause 


Causes output to pause after each page. 
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DESIGNING A REPORT 

Report formats vary according to their use. However, many reports assume the general format 
depicted in figure 4-1. The TITLE and HEADERS describe the report and are printed at the 
top of each page along with the page number. HEADERS are usually used to describe the 
report columns. 

The report body consists of DETAIL lines, GROUP TITLES, and TOTALS along with other 
descriptive labels. Normally, each detail line displays information from a single data entry, 
although information can appear on more than one line per entry. A DETAIL field can be 
edited to include commas, decimal points, dollar signs, and other punctuation characters. 

DETAIL lines can be sorted and grouped according to the values of data items in the entry. 
For example, a sales report may list sales results by country, region, sales office, and finally 
by individual salesman within each office. A GROUP TITLE can be printed whenever a "sort 
field" changes value. For example, when the country changes, the name of the country 
could be displayed as a GROUP TITLE. The title can be a series of characters or a data item 
value. 

SUBTOTALS can be printed for logical groups (for example, for each sales office) and 

GRANDTOTALS for the entire report. These totals add, average, or count the DETAIL fields 
in each column of the report. Like DETAIL and GROUP fields, TOTAL fields can be edited 
with punctuation characters. 







TITLE OF REPORT 




PAGE NO. 




HEADER 


HEADER 


HEADER 




GROUP TITLE 


DETAIL 


DETAIL 


DETAIL 






DETAIL 


DETAIL 


DETAIL 






DETAIL 


DETAIL 


DETAIL 






SUBTOTAL 


SUBTOTAL 


SUBTOTAL 




GROUP TITLE 


DETAIL 


DETAIL 


DETAIL 






DETAIL 


DETAIL 


DETAIL 






DETAIL 


DETAIL 


DETAIL 






SUBTOTAL 


SUBTOTAL 


SUBTOTAL 






GRANDTOTAL 


GRANDTOTAL 


GRANDTOTAL 





Figure 4-1. General Report Format 
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USING REPORT STATEMENTS 

In the report statement descriptions which follow, a report is created by adding one state- 
ment type at a time and showing how the added statements change the report. Figure 4-2 
contains the final version of the report. 



AS Oh 


: Ol/lA/76 






PAGE 


1 






BOBOiS MtPCANTILE 










ON HAND INVENTOPY 










STOCK 


SHIP DATE 


I N V t N T(jK T 












AMOUNT 




0 


H f. S SO«PLUS 














7391 Z PPr 


8/13/74 


f b,012.50 








S^OoTl^iK 


9/1 1/74 


$l<i»lc9,DQ 










12/05/75 


$l*«t9fc5.00 






bIN TOTAL 










1 


ACMt WlOoET 
















lC/01/ fb 


$553,477,066.95 






















lc/0 1 /75 


%4,70't.OO 




















540bTlAh' 


1 1/28/75 






















3739AIAE 


12/15/75 








O I N TOT AL 






Tj-3r>J,**0**,'*0O.c f 






ACMt WIDGET 














43970131^ 


3/02/58 


■tsb.oeo.oo 






i^akjinal mills 














3b«6Tl4Y 


1 1/20/75 


$358.56 






tiN total 






555,438.56 




3 


ACME WiDliET 














66S0D??S 


12/03/75 


$75,716.62 






H S SOWPLUS 














6fa50D2?b 


12/14/75 


ilb7.d5 








b65003Sb 


12/15/75 


1153.45 






Ht«JLETT-PACKAHD 














66500P2S 


11/15/75 


S7b,000.00 






tjIN TOTAL 






$151 ,057.92 


» 




TOTAL INVENTORY 






'S553, 723,b79.8S 





Figure 4-2. Sample Report 
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HEADER STATEMENTS 

Header statements are used to print report titles and column headings at the top of each 
report page. 



The form is 



H header number, print element, print position [.SPACE A [number] ] 
[.SPACE B [number] ] 



For example. 



/ 

header number 



H2. F-NAME, 20. SPACE A5 



print position number 



print element 



where 



header number 



print element 



print position 
SPACE A number 
SPACE B number 



is an integer from 1 to 9, Up to nine lines of 
header information can be printed in addition to 
blank lines created by spacing before and after 
non-blank lines. Header information with the same 
header number is printed on the same line. The 
lowest-numbered header statement is printed first, 
the next-highest numbered statement is printed 
next. Header statements do not have to be con- 
secutively numbered. 

is either PAGENO, DATE. TIME, a series of 
characters enclosed in quotes, or a data item 
name. 

PAGENO numbers consecutively each page of 
the report. 

DATE prints the date in the form: MM/DD/YY. 

TIME prints the time in the form: HH:MM:SS. 

Characters are stripped of the surrounding quotes 
and printed. The value of the specified data item 
is printed. 

See table 4-7 for descriptions of these 
parameters. 
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A header may contain up to 9 lines of information and any number of blank lines as long as 
it does not exceed the page size as defined by the output control statement, LINES=, (See 
the description at the end of this section.) 



EXAMPLE 



> F ALL INVENTORY. STOCK# 

USING SERIAL READ 

13 ENTRIES QUALIFIED 

> REPORT 

» H1.>"AS 0F;".>6 
»H1, DATE^ 15 



»H1.,PAGEN0,7I 
»H1, "PAGE", 69 



» Hg.>"BOBO'S MERCANTILE", 45 

»H3, "ON HAND INVENTORY", 45, SPACE A2 



»H7, 


"BIN#",4 




»H7, 


"SUPPLIER", 


1 4 


»H7, 


"STOCK", 33 




»H7, 


"SHIP DATE" 


, 49 


»H7, 


"INVENTORY" 


, 68 


»H8, 


"AMOUNT", 68 





Locate entries. 



Enter report statements describing 
the report headings. Character literals 
are printed as they appear in the 

statement. 

DATE and PAGENO are generated 
and printed by QUERY 



»END 



Col. Col. 
6 15 

i i 

AS OF: 01/14/76 
ff7-»BIN# SUPPLIER 



Col. 
33 



Col. 
45 



BOBO'S MERCANTILE 
ON HAND INVENTORY 



Col. 
49 



STOCK 



SHIP DATE 



Col. Col. 
68 71 

PAGE 1 



INVENTORY 
AMOUNT 
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DETAIL STATEMENTS 

Detail statements usually specify a data item name whose value changes with each data entry 
reported, although a fixed series of characters can be specified as well. The statement speci- 
fies the print position, top-of-form, line spacing, and applicable edit masks. 



The form is 



D[detail number] , print element,print position [,SPACE A [number] ] 
[,SFACE B [number] ] [,SKIpjgj] [, E j""^ ^^'^j ^ 



For example, 

D2, BADGE*, 35, SKIPB, E8 

/ \ \ \ 

detail number \ print position label 

print element 



or 



D, R3, 15, SPACE A2 
print element print position number 



where 



detail number 



is an integer from 1 to 9. If the number is omitted, 
the print element is printed on a group line when 
any control break occurs. (See the discussion of 
both group and sort statements.) The lowest 
numbered statement is printed first and others 
follow in numeric sequence. Detail statements 
with the same number are printed on the same 
line. Information from a single data entry can 
therefore be printed on up to ten separate lines. 



print element 



is either a data item name, a register statement 
(Rn) number, or a series of characters enclosed 
in quotes. A series of characters is printed without 
the surrounding quotes. It is printed once for 
each entry reported. If a data item is specified 
its value is printed for each entry reported. If a 
register statement number is specified, the data 
in the register is printed. You must enter both 
the letter R and number n . See the description 
of the Rn statement which follows. 



4-18 



REPORT 



print position 
SPACE A number 
SPACE B number 
Al 
B| 
number\ 
Z 



SKIP 



E 



I 



See table 4-7 for descriptions of these 
parameters and the edit statement which 
follows. 



EXAMPLE 

>REPOF?T 



»H1, 


"AS OF:", 6 




»H1., 


DATE, 1 5 




»H1., 


PAGENO, 7 1 




»H1.» 


"PAGE", 69 




»H2, 


"BOBO'S MERCANTILE", 


45 




"ON HAND INVENTORY", 


45, 


»H7* 


"BIN#",4 





If the same report shown in the header 
statement example contains detail state- 
ments, the result is as shown below. 



A2 



»H7, "SUPPLIER", 14 



»H7, 


"STOCK", 33 




»H7, 


"SHIP DATE", 


49 


»H7, 


"INVENTORY", 


68 


»Hg, 


"AMOUNT", 68 




»D1, 


STOCK#, 36 




»D1,LASTSHIPDATE 


,48 



This detail statement prints the 
value of STOCK# ending in col- 
umn 36. The next statement 
prints LASTSHIPDATE value on 
the same detail line ending in 
column 48. 



» END 



AS OF: 01/14/76 



BIN# SUPPLIER 



Dl detail lines 
printed once 
per entry. 



Col. 
36 



BOBO'S MERCANTILE 
ON HAND INVENTORY 



Col. 
48 



STOCK 




SHIP DATE 



6650D22S 


120375 


2457A1 1 C 


120175 


358 6T14Y 


1 12075 


7391Z22F 


120175 


5405T14F 


1 12875 


6650D22S 


1 1 1 57 5 


7391Z22F 


81374 


5405T14F 


91 174 


4397D1 3P 


30258 


3739A14F 


121575 


6650D22S 


120575 


6650D22S 


121475 


6650D22S 


121575 



PAGE 1 



INVENTORY 
AMOUNT 



MAY 1979 
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EDIT STATEMENTS 



The edit statement is used for punctuating data item values printed in a report. The state- 
ment performs such functions as suppressing leading zeros in numeric values, inserting char- 
acters such as dollar signs, dashes, commas, and decimal points. It also masks characters 
to eliminate them from the printed output. Edit statements may appear anywhere in the 
report. 



The form is 

E number, "edit mask" 



For example, 

E3, "$$$999CR" 

/ \ 

number edit mask 



where number is an integer from 0 to 9 identifying the edit 

statement. A report may have at most ten edit 
statements, each with a unique number. 



edit mask consists of from 1 to 20 characters (if the mask 

is to edit numeric data item values) or from 1 to 
the maximum record length of the output 
device (if the mask is to edit alphanumeric data 
item values). In either case, the characters must 
be bracketed by quotes. The length of the edit 
mask determines the length of the output field 
that is printed. 



ALPHANUMERIC EDIT MASKS. Alphanumeric edit masks consist of X's (used as place 
holders) and any other ASCII printing characters (used as insertion characters). QUERY 
examines the data item value specified in the detail, group, or total statement and the edit 
mask specified in the referenced edit statement, starting with the leftmost character of each. 

If the character in the edit mask is X a character from the data item value is printed in the 
corresponding position of the output field. If the character in the edit mask is any character 
other than an X, the edit mask character is printed in the corresponding position of the out- 
put field. For example, if the value ABCD is edited with the mask "X-X-X-X", the result is 
printed as A-B-C-D. 
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If there are fewer X's in the edit mask than there are characters in the data item value, the 
rightmost characters of the data item value that do not correspond to an X in the mask are 
omitted. For example, if the value ABCD is edited with the mask "XX", the result is 
printed as AB. 

If there are more X's in the edit mask than there are characters in the data item value, 
QUERY prints asterisks in place of the unused X's in the edit mask. All insertion characters 
in the mask are printed in the output field. For example, if the value ABCD is edited with 
the mask "XXXX-X", the result is printed as ABCD-*. 

Here are two more examples of alphanumeric edit masks: 

Data Item Value Edit Mask Printed Result 

A34B "X//X-X-X-X" A//3-4-B-* 
ABCD "- - - X" A 

NUMERIC EDIT MASKS. A numeric edit mask consists of the placement holders (9, Z, 
*, $), the sign characters (CR,-), and any other ASCII printing characters used as insertion 
characters. Each of the place holders and sign characters serves a special purpose in editing 
data item values. The characters and their meanings are specified in table 4-5. 

The numeric edit mask edits decimal integer values consisting of up to 20 characters (not 
counting the sign characters) in the combinations outlined in table 4-6. 

If the number of significant digits of the data item value is greater than the number of place 
holders (9, Z, *, $) in the edit mask, the output field is filled with asterisks. For example, if 
the value 12345 is edited with the mask "999CR" the result is *****. 

Only one decimal point may appear in any edit mask. 

If a minus sign appears in the mask in any position other than the rightmost character of the 
mask, the minus is treated as an insertion character. For example, if the value 12345 is 
edited with the mask 999-99, the result is 123-45. 

Figure 4-3 shows the results of printing numeric data item values using numeric edit masks. 

REAL NUMBERS, Real values (type R2 and R4) cannot be edited. They are printed in 
either fixed (xx.xxx) or floating point (xx.xxxE± xx) form, depending upon the magnitude 
of the value. R2 values less than .1 or greater than 10^ and R4 values less than .1 or greater 
than lO^'-^ are printed in floating-point notation. All other R2 and R4 values are printed in 
fixed-point notation. 

Fixed R2 values occupy up to eight characters and floating-point R2 values up to 12 characters 
R4 values occupy up to 18 and 22 characters for fixed and floating-point respectively. 
For example: 



Real Value 


Type 


Report Output 


0 


R2 


.OOOOOOE+00 


8399607 


R2 


.839961E+07 


-.863617E-77 


R2 


-.863617E-77 


-3.34567 


R2 


-3.34567 


-.000000034567 


R2 


-.345670E-07 


12345678987654321234567 


R4 


.1234567898765432E+23 


.000333444555 


R4 


.3334445550000000E- 03 
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Table 4-5. Numeric Edit Mask Characters 



CHARACTER EXPLANATION 



9 Each 9 in the edit mask is replaced with a decimal digit from the data 

item value in the corresponding position of the output field. 

Z Z is a zero suppression place holder. A Z in the edit mask is replaced 

with a decimal digit from the data item value in the corresponding 
position of the output field. If the data item value digit under con- 
sideration is a zero appearing to the left of the leftmost significant 
digit, QUERY inserts a blank in the output field, and all other zeros 
to the left of the significant digit are replaced by a blank in the out- 
put field. 

* * is an asterisk place holder. An * in the edit mask acts just like a Z 

with the exception that leading zeros in the data item value are re- 
placed with asterisks in the output field. 

$ $ is the dollar sign place holder. A $ in the edit mask acts just like 

a Z, except that the first zero in the data item value to the left of 
the leftmost significant digit is replaced with the dollar sign in the 
output field. All zeros to the left of the first leading zero are replaced 
with blanks in the output field. 

OR OR is a sign character, and always appears in the two rightmost posi- 

tions of the edit ipask. If the data item value is negative, QUERY 
prints the two characters (CR) in the first two rightmost positions of 
the output field. If the data item value is positive, QUERY prints two 
blank characters in place of the CR. No characters from the data item 
value are ever placed in the first two rightmost positions of the output 
field. 



- is a sign character and acts the same as the CR characters. If the data 
item value is negative, QUERY prints the minus sign (-) in the rightmost 
position of the output field. If the data item value is positive, QUERY 
prints a blank in place of the minus. No character from the data item 
value is ever placed in the rightmost position of the output field. 

Insertion Insertion characters consist of any ASCII printing characters not 

characters previously mentioned. Insertion characters are printed in the output 

field in the same position they appear in the edit mask. Any insertion 
character appearing in the edit mask to the left of the leftmost signifi- 
cant digit of the data item value is replaced with blanks or an asterisk, 
depending upon which zero suppression character is specified in the 
edit mask. Only one decimal point can appear in an edit mask. 
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Table 4-6. Numeric Edit Mask Combinations 



COMBINATIONS 


EXAMPLE 


9's only 


"99" 

"999999" 
"9999" 


Z's only 


"ZZ" 

"ZZZZZZZZZZ" 


Asterisks only 




Dollar signs only 


"$$$$" 


Sign characters preceded by 9's 


"9999CR" 
"999999-" 


Sign characters preceded by 9's which are preceded by Z's, 
asterisks, or dollar signs 


"$$$999CR" 
"ZZ99999-" 
"******9999999CR" 


9's preceded by Z's, asterisks, or dollar signs 


"$$$999999" 
"ZZZZ9999" 
"***99999999" 


Any of the above combinations including insertion charac- 
ters such as commas, one decimal point, slashes, etc. located 
anywhere in the edit mask, except to the right of sign 
characters. 


"$$999,999.99-" 
"999-9999" 
"99/99/99" 
"$$9999.99CR" 



DATA ITEM VALUE 


EDIT MASK 


PRINTED RESULT 


0059 


"$$$,999" 


$059 


001024 


"ZZZ,ZZZ" 


1,024 


-0010555 


"$$,$$$.99CR" 


$105.55CR 


00010555 


"$$,$$$.99CR" 


$105.55 


-0010555 


"$$,$$$.99-" 


$105.55- 


00010555 


"$$,$$$,99-" 


$105.55 


15039250 


"$,$$$,$$$.99CR" 


$150,392.50 


00049 


"»*»•*" 




044240474 


"999-99-9999" 


044-24-0474 


-2145 


"$.$$$.99" 


$21.45 



Figure 4-3. Sample Output Using Numeric Edit Masks 
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EXAMPLE 



> REPORT 

» H1.>"AS OFt'Se 

» H1., DATE, 15 

» H1,PAGEN0.>7 1 

» H1 ■> "PAGE", 69 

» H2,"B0B0'S MERCANTILE", 45 

»H3,"0N HAND INVENTORY", 45, SPACE A2 



»H7, 


"BIN#",4 




»H7, 


"SUPPLIER", 


14 


»H7, 


"STOCK", 33 




»H7, 


"SHIP DATE" 


, 49 


»H7, 


"INVENTORY" 


, 68 


»H8, 


"AMOUNT", 68 




»D1, 


STOCK#, 36 





» D1,LASTSHIPDATE, 48, E2 
»E2, "XX/XX/XX" 



»END 




Edit LASTSHIPDATE with mask E2. 
Define mask E2. 



Now the report looks like this: 



OF: 01/14/76 



BOBO'S MERCANTILE 
ON HAND INVENTORY 



PAGE 1 



N# SUPPLIER 



STOCK 

6650D22S 
2457A1 IC 
358 6T14Y 
7391Z22F 
5405T14F 
6650D22S 
7391Z22F 
5405T14F 
4397D1 3P 
3739A14F 
6650D22S 
6650D22S 
6650D22S 



SHIP DATE 

12/03/75 
1 2/01/75 
1 1/20/75 
12/01/75 
1 1/28/75 
11/15/75 
8/13/74 
9/1 1/74 
3/02/58 
1 2/ 1 5/75 
1 2/05/75 
12/14/75 
12/15/75 



INVENTORY 
AMOUNT 
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SORT STATEMENTS 

The sort statement serves two purposes in the REPORT command; it 

• specifies data items whose values are used to sort data entries when they are printed in 
the report, 

• defines control break levels for use by group and total statements in the report. 



The form is 

S [level] , data item name j^ggj J 



For example, 



S3, BADGE# ,ASC 

/ \ 

level data item name 



or 



S, L-NAME 

f 

data item name 



where 



level 



data item name 



DES 



ASC 



is an integer from 1 to 5. A sort statement with 
level greater than 1 must be accompanied by sort 
statements containing all lower level numbers. 
That is, if S3 appears in the report, S2 and SI 
must also appear in it. You need not specify a 
level; in this case, the sort statement sorts but 
does not define a control break. 

is the name of a data item contained in data 
entries selected by the last FIND command. If 
you last used FIND CHAIN, you may not use a 
master data item name in the sort statement. 

indicates that the data item values are to be 
ordered in descending order. 

indicates that the data item values are to be 
ordered in ascending order. If you do not 
specify ASC or DES, the default order is ASC. 
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The sort statement: 
S1,L-NAME 

sorts the entries selected into the order specified by the value of L-NAME. 

Data Entries After FIND Data Entries After Sort Executed 



L-NAME 


F-NAME 


AGE 


L-NAME 


F-NAME 


AGE 


WHITE 


ROB 


26 


BROWN 


JACK 


32 


BROWN 


JACK 


32 


BROWN 


CHRIS 


17 


GREEN 


ROB 


49 


BROWN 


DAN 


39 


WHITE 


LARRY 


81 


GREEN 


ROB 


49 


BROWN 


CHRIS 


17 


GREEN 


SAM 


28 


GREEN 


SAM 


28 


GREEN 


BILL 


45 


GREEN 


BILL 


45 


WHITE 


ROB 


26 


BROWN 


DAN 


39 


WHITE 


LARRY 


81 


WHITE 


WILL 


22 


WHITE 


WILL 


22 



You can sort on many different data items. The higher-numbered sort statement identifies 
the major (or first) sort field, while the lower-numbered sort statement identifies the minor 
sort field. The minor sort arranges entries in the order specified, keeping all major sort items 
with identical values together, in other words, it sorts within subsets of the entire set of 
entries. For example, if the statement illustrated above appeared in a report with another 
statement: 

51, F-NAME 

52, L-NAME 

the result would be as follows: 





L-NAME 




F-NAME 


AGE 


level 2 (major) 


►BROWN 


level 1 (minor) 


^^^CHRIS 


17 


control break 


BROWN 


control breaks 


►DAN 


39 




BROWN 




^*^JACK 


32 


level 2 (major) 


►GREEN 




BILL 


45 


control break 


GREEN 




ROB 


49 




GREEN 




SAM 


28 


level 2 (major) 


►WHITE 




LARRY 


81 


control break 


WHITE 




ROB 


26 




WHITE 




WILL 


22 
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CONTROL BREAKS. A control break occurs during the printing of a report whenever the 
current entry's value for a data item defined in a numbered sort statement is different from 
the last entry's value. When the first entry is printed, a control break occurs since the data 
item value changes from null (no value) to the first value. Totals are not printed when the 
first control break occurs. 

In the examples above, a control break occurs when the value of L-NAME becomes BROWN 
and when it changes to GREEN, and again when it changes to WHITE. This is known as a 
level 2 control break because the data item named L-NAME appears in a sort statement labeled 
S2. The level 1 control break is associated with the data item named F-NAME and sort state- 
ment labeled SI . 

A control break occurs for all lower levels whenever a higher level control break occurs. This 
means that whenever a control break occurs for level 2 (L-NAME), a control break occurs for 
level 1 (F-NAME) by definition. 

A group or total statement prints only when a control break occurs that is at the same level 
as the group or total statement. This means that a total statement labeled Tl prints only 
when a level 1 control break occurs, or a group statement labeled G2 prints only when a level 
2 control break occurs. Consult the descriptions of group and total statements below for 
explanation of their functions. 

Sort statements with no level (i.e., no number) are used to sort entries but do not define 
control breaks for use by group or total statements. 

MAJOR TO MINOR SORT FIELDS. Numbered and unnumbered sort statements can 
appear in the same REPORT command. The order in which unnumbered sort statements 
appear in the report body is significant. The first unnumbered statement defines the most 
minor sort field, while the last unnumbered statement defines the most major sort field. 
QUERY defines sort fields in the following order from most major to most minor: 

Most Major Most Minor 

85 S4 S3 S2 SI S{last in report body) S(first in report body) 

For example, the sort statements below define the order as shown: 



Statements 



Order 



S2,OFFICE 
S,PARTNO 
S1,SLSMAN 



MONTH ^ major 
OFFICE 



SLSMAN 



(S3) 
(S2) 
(SI) 



S,QUANTITY 
S3,M0NTH 



QUANTITY 
PARTNO -f- minor 



(S last) 
(S first) 
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MAXIMUM NUMBER OF SORT ITEMS. The number of data items you may use to sort 
is limited in two ways: 

• the combined length of the data items appearing in all the sort statements must not 
exceed 2045 words, 

• the maximum number of sort statements allowed in a single report is 66. In other words, 
you may have up to 66 sort statements provided that the combined length of the data 
items in all of the 66 statements is not greater than 2045. 

EXAMPLES 
>REPORT 



»H1., 


"AS OF: ".,6 




»H1., 


DATE, I 5 




»H1., 


PAGENO> 7 1 




»H1^ 


"PAGE'S 69 




»H2j 


"BOBO'S MERCANTILE"., 


45 


»H3> 


"ON HAND INVENTORY", 


45, SPACE A2 


»H7/ 


"BIN#", 4 




»K7j 


"SUPPLIER", 14 




»H7j 


"STOCK", 33 




»H7> 


"SHIP DATE", 49 




»H7j 


"INVENTORY", 68 




»H8j 


"AMOUNT", 68 




»D1., 


STOCK#, 36 




»D1, 


LASTSHIPDATE, 48, E2 




»E2j 


"XX /XX /XX" 




»52^ 
»Sl, 


BINNUM ^ 

SUPPL I ER~ — 





» S, LASTSHIPDATE ' Define BINNUM as sort level 2, 

»END SUPPLIER as sort level 1, and 



The detail entries are now sorted by SUPPLIER and BINNUM. The values for these items will 
be printed in group statements which are described next. 



LASTSHIPDATE as sort 
without control break. 



AS OF: 01/14/76 



PAGE 1 



BIN# 



SUPPLIER 



BOBO' S MERCANTILE 
ON HAND INVENTORY 
STOCK SHIP DATE 



INVENTORY 
AMOUNT 



7391Z22F 
5405T14F 
6650D22S 
2457AI IC 
7391Z22F 
5405T14F 
3739A14F 
4397D1 3P 
3586T14Y 
6650D22S 
6650D22S 
6650D22S 
6650D22S 



8/13/74 
9/1 1/74 
2/05/75 
2/01/75 
2/01/75 
1/28/75 
2/15/75 
3/02/58 
1/20/75 
2/03/75 
2/14/75 
2/15/75 
1/15/75 
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GROUP STATEMENTS 

A group statement prints the value of a data item, the value in a register (Rn), or a series of 
characters whenever a control break occurs. 



The form is 



G level, print element, print position [,SPACE A [number] ] [,SPACE B [number] ] 

I' 



[.SKIP ] [,Ej""f-)] 



For example, 

G3, WEEK, 35, SKIP B, E2 

/ t \ \ 

level I print position number 

print element 



or 



Gl, R3, 55 ,SPACE B2 

M \ \ 

prmt position number 



level 
print element 



where 



level 



print element 



is an integer from 1 to 5 corresponding to the 
level of a sort statement. 

is either a data item name, a register statement 
number (Rn), or a series of characters enclosed 
in quotes. (The quotes are stripped when the 
characters are printed.) 



print position 
SPACE A number 
SPACE B number 
A 



SKIP 



E 



B 

number 



See table 4-7 for descriptions of these 
parameters. Also see the edit statement 
description in this section. 



MAY 1979 
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Each control break occurs as a result of a sort statement labeled from 1 to 5. When the 
control break occurs, the group statement with the same number as the sort statement prints 
the information you specify. (See the explanation of control breaks given under sort state- 
ments for more information.) 

Whenever a control break occurs, all group statements with a number equal to or less than 
the level of the sort statement causing the break print a value or series of characters. All 
group statements print on the same line. 

Since a control break always occurs at the very beginning of the report, all group statements 
print their contents before any detail statements are executed. 

If the REPORT command contains group statements but no sort statements, an error is 
printed when the command is completed. 



EXAMPLES 



>REPORT 

» H1.>"AS OF'.", 6 

» H1, DATE.> 1 5 

» H1.>PAGEN0, 7 1 

» H1, "PAGE'S 69 

» H2.,"B0B0'5 MERCANTILE"., 45 

»H3.,"0N HAND INVENTORY"., 45.. SPACE A2 



»H7.» 


"BIN#",4 




»H7.» 


"SUPPLIER", 14 


»n7j 


"STOCK", 33 




»H7j 


"SHIP DATE", 


49 


»H7> 


"INVENTORY", 


68 


»H8., 


"AMOUNT", 68 




»D1, 


ST0CK#,36 




»Pl/ 


LASTSHIPDATE 


, 48,E2 


»E2., 


"XX /XX /XX" 




»S2> 


BINNUM 




»S1, 


SUPPLIER 





^^ ^^^^tL?^^^^!^ > >..r. r, BINNUM Will be printed when a 

»G2, BINNUM, 3, SPACE P ^ j. i u , j: ^, i 

uciji u ,o,oj-«v..i. ^ control break occurs for sort level 



»G I, SUPPLIER, 20 _ 2, and 



''^ SUPPLIER when a sort level 1 



control break occurs. 
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AS OF: 01/14/76 



BOBO'S MERCANTILE 
ON HAND INVENTORY 



PAGE 1 



BIN# SUPPLIER 



0 HAS SURPLUS 



1 ACME WIDGET 
BAY PAPER CO. 
CARDINAL MILLS 
JAKE'S JUNK 

2 ACME WIDGET 
CARDINAL MILLS 

3 ACME WIDGET 

H & S SURPLUS 

HEWLETT- PACKARD 



STOCK 



7391Z22F 
5405T14F 
6650D22S 



2457A1 1 C 
7391Z22F 
5405T14F 
3739AI4F 

4397D1 3P 
3586T14Y 

6650D22S 

6650D22S 
6650D22S 

6650D22S 



SHIP DATE 



8/13/74 
9/1 1/74 
12/05/75 



INVENTORY 
AMOUNT 




3/02/58 
1 1/20/75 

1 2/03/75 

12/14/75 
12/15/75 

1 1/15/75 



level 1 and level 2 
control break 



level 1 control break 



level 1 and level 2 
control break 



Notice that the two data items mentioned in the detail statements do not print on the same 
line as the group statements. This is because the detail statements are numbered. Unnumbered 
detail statements print on the same line as a group statement whenever a control break occurs. 
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TOTAL STATEMENTS 

The total statement prints a data item value, the value in a register (Rn), a series of characters, 
the total, average, or coimt of a group of data items whenever a control break occurs. 



The form is 



T level,print element,print position [, SPACE A [number] ] 



[ 



,SPACE B [number] ] |^,SKIP j ^ j J |^,E j 



j number] 





ADD 




> 


AVERAGE 


0 




COUNT 





or the special form 
T level, Rn 



For example. 



T4, WAGES, 60, SKIP A, E2, ADD 

f f \ \ 

level I print position number 



print element 



or 



Tl, "TOTAL WAGES=", 40, SPACE B5 

/ f f \ 

level print element print position number 



or 



level 
where 



T3, R2 



level 



is the letter F or an integer from 1 to 5 corres- 
ponding to the level of a sort statement. The 
letter F indicates the information is to be 
printed only at the end of the report after the 
last detail line and it relates to the entire report, 
not just a subgroup. 



print element 



is either a data item, a register statement number 
(Rn), or a series of characters enclosed in quotes 
(a character literal). The characters are printed 
without the surrounding quotes. 
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print position 
SPACE A number 
SPACE B number 

SKIP ^ 



E 



B 

(number] 
Z j 



ADD 

AVERAGE 

COUNT 
Rn 



\ 



See table 4-7 for definitions of these para- 
meters. Also see the description of the edit 
statement. 



indicates that you want to print the control 
group total of the values for the data item 
specified as the print element. 

indicates you want to print the control group 
average value for the data item specified as the 
print element. 

indicates you want to print a count of the 
number of values for that control group. 

is the number of a register to be cleared. 



If the total statement is labeled TF, the ADD, AVERAGE, and COUNT options apply to all 
occurrences of the data item in the report. The options ADD and AVERAGE are not 
allowed on ASCII (U or X type) data items. If ADD, AVERAGE, or COUNT is used, the 
print element must be a data item name. 

If you use the special form of the command, specifying only a register number without a 
print element, the register is cleared (reset to zero) when a control break occurs. 

A control break results from a sort statement labeled from 1 to 5. When a control break 
occurs, the total statement corresponding to the sort level causing the break prints the infor- 
mation you specify. (See the description of the sort statement for more information about 
control breaks.) 

Total statements must be accompanied by sort statements or an error is printed when the 
REPORT command is completed. 

To perform more than one operation on the same data item (total, average, count) you must 
specify a separate total statement for each operation. The desired information is printed on 
the same line ending in the column position specified if you use the same level for each 
statement. 



MAY 1979 



4-33 



REPORT 



EXAMPLE 



>REPORT 

»H1^"AS OF:"* 6 




»HI, DATE, 1 5 




»H1>PAGEN0,7 1 




»H1, "PAGE'S 69 




»H2, "BOBO'S MERCANTILE", 


45 


»H3, "ON HAND INVENTORY", 


45, SPACE 


»H7, "BIN#", 4 



» H7, "SUPPLIER", 14 
» H7, "STOCK", 33 
» H7,"SHIP DATE", 49 
» H7, "INVENTORY", 68 
» H8, "AMOUNT", 68 
» D1, STOCK#, 36 
» D1,LASTSHIPDATE,48, Eg 
» Eg, "XX/XX/XX" 
» Sg, BINNUM 
» SI, SUPPLIER 
» S,LASTSHIPDATE 
» Gg, BINNUM, 3, SPACE B 
» G1, SUPPLIER, 20 
»T2, " *",70 



» T2, "BIN TOTAL", 14, SPACE A 

»TF, "TOTAL INVENTORY", 20, SPACE B3 

» TF, " ♦♦",71 

»END 




This statement prints an asterisk 
in column 70 and the next one 
prints a character literal when a 
level 2 control break occurs. 



When the final totals are printed, 
these statements print the specified 
characters. 



The total statements which have been added merely print character literals. The totals are 
computed with register statements which are described next. More total statements are 
added in the example of register statements. 
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AS OF! 01/14/76 



BOBO'S MERCANTILE 
ON HAND INVENTORY 



REPORT 

PAGE 1 



BIN# SUPPLIER 



0 H & S SURPLUS 



STOCK 



7391Z22F 
5405T14F 
6650D22S 



BIN TOTAL 



SHIP DATE 



8/1 3/74 
9/1 1/74 
12/05/75 

— level 2 control break - 



INVENTORY 
AMOUNT 



1 ACME WIDGET 

BAY PAPER CO. 
CARDINAL MILLS 
JAKE' S JUNK 
BIN TOTAL 



2457A1 IC 
7391Z22F 
5405T14F 
3739A14F 



1 2/01/75 
12/01/75 
1 1/28/75 
12/15/75 



2 ACME WIDGET 

CARDINAL MILLS 
BIN TOTAL 



4397D13P 
358 6T14Y 



3/02/58 
1 1/20/75 



3 ACME WIDGET 

H & S SURPLUS 

HEWLETT-PACKARD 
BIN TOTAL 



6650D22S 

6650D22S 
6650D22S 

6650D22S 



12/03/75 

12/14/75 
12/15/75 

1 1/15/75 



TOTAL INVENTORY 
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REGISTER STATEMENTS 

A register statement specifies an operation to be executed in one of ten QUERY registers. 
The register statements are executed sequentially as they appear in the REPORT command, 
once for each data entry in the report (that is, once for each entry selected by the last FIND 
command.) 



The form is 






f L [OAD] >| 






A [DD] 




R number, -i 


S [UBTRACT] 


f. , data element 




1 M [ULTIPLY] 






[d [IVIDE] ^ 





For example, 

R3, ADD,PRICE 
number data element 



or 

RO, M, "25" 
number data element 

or 

R5, DIV, R6 
number data element 

where number 

data element 



LOAD 



ADD 

SUBTRACT 



is an integer between 0 and 9 which identifies 
the register you want to use. 

is a numeric type data item name, a register 
number (Rn), or a number enclosed in quotes (a 
numeric literal). The quotes are required. QUERY 
strips them and uses the number in the operation. 

indicates you want to replace the current contents 
(if any) of the register with the data element. 

indicates you want to add the data element to 
the contents of the register. 

indicates you want to subtract the data element 
from the contents of the register. 
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MULTIPLY indicates you want to multiply the contents of 

the register by the data element. 

DIVIDE indicates you want to divide the contents of 

the register by the data element. 

After each operation is executed, the result is placed in the register you specify at the 
beginning of the statement. For example, if R2 contains an integer 3, R4 contains an 
integer 2, and this statement is executed: 

R2, MULTIPLY, R4 

R2 will contain an integer 6. 

USING QUERY REGISTERS. The register statements in a REPORT command describe 
a fixed sequence of operations to be performed each time a new data entry is processed for 
the report. If you are familiar with programming techniques, you may consider the Rn 
statements as a program "loop" or routine which is executed once for each data entry 
included in the report. 

Rn statement execution affects only the ten QUERY registers. No output results from the 
statements although you may print the content of any register by using other REPORT com- 
mand statements (with the exception of sort and header statements.) 

All register operations except LOAD are cumulative. In other words, when each Rn state- 
ment is executed, the current contents of the register are operated on by the data element 
and the result is stored in the register again. 

INITIALIZING REGISTERS. Each register is initialized to zero when the REPORT 
command begins execution. You may reset a register to zero in two ways: 

• load a zero into the register. For example, 

R3, L, "0" 

• use a total statement to reset the register to zero when a control break occurs. For 
example, the statement: 

T2, R3 

sets Register 3 to zero when a control break occurs as a result of sort level 2. 
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An arithmetic operation may also reset the register to zero. For example, 

R4, SUBTRACT, QUANTY (where QUANTY is equal to the contents of R4) 

If you divide the contents of a register by zero, the result is zero. Results of integer division 
are truncated. 

REGISTER AND DATA TYPES. Only numeric type data can be used in register operations. 
The following IMAGE data item types are allowed: 

• whole numbers or integers (II, 12, Jl, J2, Kl, Zn, and Pn) 

• real numbers (R2) 

• extended precision real numbers (R4). 

You can mix data types in a register operation; for example, you can add an integer to a 
real number. QUERY determines the data type of the register content after such an operation 
by assigning an order of precedence (or rank) to the data types. The order is: 

HIGHEST R4 (Extended precision type data) 

R2 (Real type data) 

LOWEST II, 12, Jl, J2, Kl, Zn, Pn (Integers and packed decimal numbers) 

The new register content always has a data type which is the higher of the two operand types: 
the old register content or the data element. For example, if Register 2 is loaded with an 
integer and then multiplied by a real type data item: 

R2,L,"3" 

R2,M,PERCENT (where the value of PERCENT is 25.6) 

the content of R2 will be type real after the statements have been executed. 

The maximum size integer (including all IMAGE integer data types) which a register can con- 
tain is 19 digits. 
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Real and extended precision numbers have the same hmits in registers as IMAGE R2 and 
R4 data items. R2 can have 6 to 7 significant digits and R4 can have 16 to 17 significant 
digits. If a register calculation results in overflow or underflow, a message is printed on the 
$STDLIST device. 

When mixing data types in arithmetic register computations, you should think about the 
order of precedence and its effect on the calculations. For example, if you operate on a 
real register number with an integer having 12 significant digits, the result will have 6 to 7 
significant digits. 

NUMERIC LITERALS. To use a constant number in a register operation, you enter the 
number surrounded by quotes (for example, "325", ".0013", "-3E-6"). This type of 
number is called a numeric literal. 

Integer numeric literals can have at most 19 digits. The length of real numeric literals is 
limited only by the line length (or input record length). Limits for real numeric literal 
values and significant digits are the R2 limits. Numeric literals may contain the following 
characters within the quotes: 

• the digits 0 through 9 (integer and real) 

• the plus (+) and minus (-) signs (integer and real) 

• the letter E, upper or lower case (real only) 

• the decimal point (real only). 

It is not good practice to use blanks within numeric literals. They are rejected in register 
statements. 
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EXAMPLE 



>REPORT 
»H1^"AS OF: 



» H1 DATE, 1 5 
» H1,PAGEN0.>71 
»H1, "PAGE", 69 



» H2.>"B0B0'S MERCANTILE", 45 

»H3,"0N HAND INVENTORY", 45, SPACE A2 



»H7, 


"BIN #",4 




»H7, 


"SUPPLIER", 


14 


»H7, 


"STOCK", 33 




»H7, 


"SHIP DATE" 


,49 


»H7, 


"INVENTORY" 


, 68 



» H8, "AMOUNT", 68 
»D1, STOCK*, 36 



» D1,LASTSHIPDATE,48,E2 
»D1,R7,68,E1 ^ 1 



» E2, "XX/XX/XX" 
» E1, "$S$, $$$, $S$, $$$»99' 
» S2,BINNUM 
» SI, SUPPLIER 
» S,LASTSHIPDATE 
» G2,BINNUM,3,SPACE B 
»G1, SUPPLIER, 20 



» R7, LOAD, ONHANDQTY 
»R7, MULT, UNI T- COST 




» R8, ADD, R7 
»T2,R8, 68, El, SPACE B 
»T2, 




» T2, R8 

» T2,"BIN TOTAL", 14, SPACE A 
» TF, "TOTAL INVENTORY", 20, SPACE B3 
» TF, " 7 1 

» TF,R9, 68, E l, SKIP A 
» R9,ADD,R7 
»END 



-Add detail statement to print the 
content of Register 7 and edit with 
El. 



Load the value of ONHANDQTY 
into R7 and multiply by UNIT-COST. 
Add the result to the contents of R8. 

Add more total statements to print 
the content of Register 8 at each 
level 2 control break and clear 
Register 8. 

■Add a total statement to print the 
content of Register 9 on the final 
total line. R 7 is added to R9 each 
time another entry ^s data is printed 
in the report. 



Note: Each register statement is executed each time a new entry's data is printed in the 
report. 
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AS OFz 01/14/76 



BOBO'S MERCANTILE 
ON HAND INVENTORY 



REPORT 



PAGE 1 



BIN# SUPPLIER 



0 H & S SURPLUS 



BIN TOTAL 

ACME WIDGET 
BAY PAPER CO. 
CARDINAL MILLS 
JAKE'S JUNK 

BIN TOTAL 



STOCK SHIP DATE 

ONHANDQTYX UNIT-COST 



7391Z22F 
5405T14F 
6650D22S 



8/13/74 
9/1 1 /74 
12/05/75 



Accumulated R 7 values 
in R8. R8 set to 0 




INVENTORY 
AMOUNT 



$5,012.50 
$12* 129. 60 
$14*985.00 

.$32* 127. 10 * 



2457A11C 12/01/75 $553*477*666.95 
7391Z22F 12/01/75 $4*704.00 
5405T14F 11/28/75 $1*396.00 
3739A14F 12/15/75 $1*189.32 

$553*484*956.27 * 



2 ACME WIDGET 

CARDINAL MILLS 

BIN TOTAL 



4397D13P 
3586T14Y 



3/02/58 
1 1/20/75 



$55* 080. 00 
$358. 56 
$55*438.56 * 



3 ACME WIDGET 

H & S SURPLUS 

HEWLETT-PACKARD 

BIN TOTAL 



6650D22S 

6650D22S 
6650D22S 

6650D22S 



12/03/75 

12/14/75 
12/15/75 

1 1/15/75 



$75* 71 6. 62 

$187.85 
$1 53. 45 

$75* 000. 00 

$151*057.92 * 



TOTAL INVENTORY 



Accumulated R7 
values 



'$553*723* 579.85 ♦* 
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OUTPUT CONTROL STATEMENTS 

Output control statements may be included in a REPORT command to alter the standard 
parameters for report output. 

There are four output control parameters. The form and purpose of each statement is: 



LINES=m^e^er 



Specifies the number of lines per report p^e. 



and 



NOPAGE 



and 



and 



[OUT=] LP 



Suppresses page advancing at the beginning of 
each page (no margins are provided at the top 
and bottom of each page). All SKIP options 
are ignored, and all SPACE options are 
performed unconditionally. 

Sends the report output to the QSLIST device. 
Applies only to the current report. 



PAUSE 



Causes report output to pause after each page 
completes. Press return to continue. PAUSE 
is ignored in job mode or output is sent to 
QSLIST. 



where 



integer 



specifies the number of lines per report page. 

integer may be 0 which makes the page size 
infinite or between 10 and 32767. 



The standard parameters for report output are: 

• 60 lines per page 

• page advancing at the beginning of each report page 

• output printed on the $STDLIST device (the terminal in session mode and line printer 
in job mode). 

• no pauses while report is being printed. 



If you are using the REPORT ALL form of this command, these statements must precede 
the keyword ALL. 
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EXAMPLE 



> F ALL LAST-NAME 
USING SERIAL READ 
13 ENTRIES QUALIFIED 
>REPORT ALL 



Locate all CUSTOMER entries. 



Print them without output control 
statements. 



ACCOUNT 

LAST-NAME 

FIRST-NAME 

INITIAL 

< CONTROL Y 



=54283540 
=CORCORAN 
= CLIFFORD 



>REPORT nopage;all 



=54283540 
=C0RC0RAN 
=CLI FFORD 
= C 

= 6105 VALLEY 



ACCOUNT 
LAST-NAME 
FIRST-NAME 
INITIAL 

STREET- ADDRESS 
CITY 

< CONTROL Y > 



>REPORT 0UT=LP;ALL 
> REPORT LINES=8;ALL 
NUMERIC VALUE ERROR 
>REPORT 

»D1.,LA5T-NAME.> 20> SPACE AS 
» PAUSE 
» LINES= 10 
»END 



Terminate the list with Control Y. 

Use the NOPAGE output control 
statement. QUER Y does not skip lines 
for a top of page margin. 




GREEN DR. 

Specify output to the QSLIST device. 
Use the LINES= statement to set the 
number of lines per page (cannot be less 
than 10 unless 0). 



Print a simple report with LINES=10 
and a PAUSE statement. 



CORCORAN 



MAYFIELD 



WHITE 
DELLWIG 




.After 10 lines, QUERY pauses and return 
must be pressed to continue the listing. 



FIELD 
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Executes a REPORT command stored on the current Proc-file as a procedure. 



The form of the REPORT command when used for this purpose is 
( REPORT 



[output control statements] procedure name [^character] 



For example, 



REPORT REP4,J^ 
procedure name character 



or 



REP TAX 

t 

procedure name 
where output control statements 



see the output control statements in this 
section. 



procedure name 



character 



is the name of a REPORT command stored 
as a procedure on the current Proc-file. 

is any printable ASCII character. If 
character is included in the command, the 
REPORT procedure is listed before it is 
executed. 



QUERY searches the current Proc-file and executes the REPORT command stored under the 
procedure name. The data entries used are those located by the previous FIND command. If 
the procedure does not exist on the current Proc-file, or if the Proc-file has not been declared, 
QUERY prints an error message. 

Before the procedure is executed, QUERY checks it for proper format. If any statement 
(except the first one) is incorrect, QUERY issues an error message and prompts you with a 
"> >". At this point, you may enter one or more statements to replace the statement causing 
the error. The statements must be on one line and separated by semicolons. If any of these 
substitute statements is in error, QUERY issues another error message and prompts you again. 
Once satisfactory statements have been entered, QUERY executes the procedure using the 
newly-entered statements in place of the statements in error. If the first report statement is 
in error, the REPORT command terminates. 

The corrected statements are not permanent. Once the procedure has executed, the entered 
statements are lost. The procedure remains unchanged on the Proc-file. To permanently 
change the procedure, you must use the ALTER command. 
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Figure 4-4 for example, shows a REPORT procedure named REP4. The third Une contains a 
sort statement with a comma missing. When the procedure is executed using the command: 

>REPORT REP4 



PROCEDURE: REP4 


001 


REPORT 


002 


HI, "MONTHLY SHIPMENTS", 25* SPACE A2 


003 


SI STOCK* 


004 


G l, STOCK#, 1 5 


005 


D1,LASTSHIPDATE, 25 


006 


END 



Figure 4-4. REPORT Procedure Named REP4 



QUERY prints the offending sort statement and prompts for a correction as follows: 

003 SI STOCK# 
EXPECTED A ' 
» 

Once you enter a correct statement or series of statements, execution of the procedure 
continues. For example, you might respond with: 

003 SI STOCK* 
EXPECTED A ' 
» S1, STOCK#J S,LASTSHIPDATE 

Not only has the sort statement been temporarily fixed, but another sort statement has been 
added as well. Once the procedure has executed, the corrections and additions are lost. 
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Statements may also contain options (parameters) which perform such tasks as skipping to 
the top of the next report page, spacing between report lines, and indicating edit masks to 
be used to insert punctuation such as decimal points, dollar signs, etc., into values printed 
in the report. These options are described in table 4-7. 



Table 4-7. Statement Parameters 



PARAMETER 


FUNCTION 


APPLICABLE 
STATEMENTS 


print position 


determines the rightmost print position 
(column number) for the print element. 
For character data, this is the rightmost 
character; for numeric data, it is the 
position of the least significant digit. 


Header, Detail, 
Group, Total 


SPACE A [number] 


Space number lines after printing the 
report line. If number is omitted, one 
line is spaced. 


Header, Detail, 
Group, Total 


SPACE B [number] 


Space number lines before printing the 
report line. If number is omitted, one 
line is spaced. 


Header, Detail, 
Group, Total 


number 


is the number of lines to be spaced 
(from 1 to 5). 




SKIP {^) 


Skip to the top of the next report page 
after printing the report line (SKIP A) 
or before printing the report line 
(SKIP B). 


Detail, Group, 
Total 


I number\ 

i z i 


indicates that either an edit mask defined 
in the identically numbered edit state- 
ment (Enumber) is to be used to punctu- 
ate a value or, if you use the letter Z, 
that leading zeros are to be suppressed. 
In the latter case, no edit statement is 
required. 


Detail, Group 
Total 
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SKIPPING AND SPACING 

When paging is in effect, the following rules govern skipping and spacing: 

1. If a SKIP B and a SPACE B are both associated with the same output line, the SKIP B 
is processed before the SPACE B. 

2. If there are not enough lines remaining on the current page to satisfy a SPACE B, a 
page is ejected and then the spacing is effected. 

3. If a SKIP A and a SPACE A are both associated with the same output line, the SPACE A 
is ignored. 

4. If there are not enough lines remaining on the current page to satisfy a SPACE A, it is 
treated as a SKIP A. 



MAY 1979 



4-45b 



USING PROCEDURES 
AND XEQ FILES 



SECTION 



A single QUERY command can be fully defined, named, and stored as a procedure in a file 
for future use. The command forms which may be stored as procedures are listed in table 
5-1. A procedure can be defined completely within QUERY using the CREATE and ALTER 
commands below, or it can be defined by the EDITOR. 

Procedures are stored in an MPE ASCII file called a Proc-file. Although you may have more 
than one file containing procedures, only one Proc-file can be "active" at a time. In this 
manual, the "active" Proc-file is usually referred to as the current Proc-file. 

Before using the Proc-file, you must inform QUERY which one you wish to use through the 
PROC-FILE= command or in response to the PROC-FILE prompt issued by the DEFINE 
command. Any procedure command thereafter automatically references the current Proc- 
file. If a Proc-file name specified in a PROC-FILE= command or in response to the 
PROC-FILE prompt does not refer to an existing file, QUERY automatically creates a new 
file for you. 

A procedure is executed by referencing it in a FIND, REPORT, or UPDATE procedure 
command. The forms of these commands are specified in Sections III and IV. 

Table 5-1. Commands Allowed as Procedures 



FIND 

FIND CHAIN 


UPDATE ADD 
UPDATE REPLACE 


UPDATE or U 
is required. 


FIND ALL 


UPDATE DELETE 

f 




REPORT 






REPORT ALL 







This section describes the commands you need to work with procedures. The commands 
and their functions are: 

• CREATE Creates procedures and stores them on the Proc-file indicated in the last 

PROC-FILE command or prompt. The option CREATE SPACE tells 
you the number of unused records in the Proc-file. 

• DISPLAY Lists the names of all the procedures stored on the current Proc-file or 

lists individual procedures complete with line numbers for use in editing. 

• ALTER Edits procedures stored on the current Proc-file, allowing you to delete, 

replace, or insert new lines into the procedure. 

• DESTROY Removes a procedure from the current Proc-file. 

• RENAME Changes the name of a given procedure. 

USING QUERY COMMANDS FROM A FILE 

A sequence of QUERY commands can be created and stored using the EDITOR, and sub- 
sequently executed using the XEQ command in session or job mode. The XEQ command 
is described at the end of this section. 
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CREATE 



Stores a command as a named procedure in the currently defined Proc-file. 



The form of the CREATE command is 

(create) {filename \ 

\ ) procedure name, \ r 

[C ] [command] 



For example, 



or 



CREATE PROCA, FILEX 
procedure name filename 



CREATE PROCZ, FIND BADGER IS " " END 

y*' ^ 

procedure name command 



where 



procedure name 



filename 



command 



is a name composed of from 1 to 8 alpha- 
numeric characters. The first character must 
be alphabetic. No special characters or spaces 
are allowed. You choose the procedure name. 
It may not be: ALL, D, DELETE, Dn, En, 
END, EZ, Gn, Hn, LIST, LP, NOP AGE, 
PAUSE, Rn, S, Sn, SPACE, TF, Tn where n is 
an integer from 0 to 9. 

is the name of an MPE ASCII file containing 
one of the commands listed in table 5-1. The 
command will be stored as a procedure in the 
Proc-file. The filename may not be FIND, 
REPORT, or UPDATE or any identically 
arranged subset of these characters (such as 
F, FI, FIN). FINDX and other supersets are 
acceptable. 

is one of the commands listed in table 5-1. 
The form of the command is the same as 
shown in the command definition in this 
manual. 



You may create a procedure in two ways: 

• from input stored in an MPE ASCII file, 

• from input entered through the session or job input device. 
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If the procedure you are creating does not fit in the available Proc-file space, an error 
message is printed. The incomplete procedure is stored and you may list it with the 
DISPLAY command. 



FILE INPUT 

If you create the procedure from a file, QUERY reads the named file when the command is 
entered. QUERY then lists what is read on the standard list device, and stores it as a proce- 
dure on the current Proc-file. The input is copied from the MPE ASCII file to the Proc-file; 
no attempt is made to check the command for form until the procedure is executed. Blank 
lines (records) are not copied to the Proc-file. 

QUERY does not process the last eight characters of each record in an MPE ASCII file. If 
you create the file using EDIT/3000 and keep it with numbered lines, the last eight charac- 
ters are the line numbers. Even if you keep the file unnumbered, QUERY commands or 
parameters should not be entered in this part of a record. 

TERMINAL INPUT 

If you enter a procedure through a terminal (in session mode) or through a standard input 
device (in job mode), the command can be entered on one line or as many lines as necessary 
without use of the continuation character (&). Whenever you press return, QUERY prompts 
for additional lines by printing ». To terminate the command, enter a pair of slashes (//) 
or END as the last three characters in a line. All the characters you enter are stored on the 
current Proc-file without checking. The procedure is checked for correct form only when it 
is executed. 

QUERY allows a maximum input record of 250 characters (bytes). If you use the continu- 
ation character (&), QUERY considers all the lines connected with it as one input record and 
the total number of characters cannot exceed 250. 
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EXAMPLES 



> CREATE FPROC.> FIND LAST-NAM E I S_ 
>FIND FPROC 



THE VALUE OF 



WHAT IS 
» MURTZ 
mAT IS THE 
» FRANZ ON I 
WHAT IS THE 
» K EN PALL 
USING SERIAL READ 
0 ENTRIES QUALIFIED 
>FIND FPROC 



VALUE DE- 



VALUE OF 



WHAT IS THE 
» DELLWIG 
WHAT IS THE 
» MEADOWS 
WHAT IS 
» return 



WHAT IS THE VALUE OF 

USING SERIAL READ 

2 ENTRIES QUALIFIED 



LAST-NAME 
LAST-NAME 
LAST-NAME 



VALUE OF - LAST-NAME 
VALUE OF - LAST-NAME 
THE VALUE OF - LAST-NAME 
LAST-NAME 



Create procedure named FPROC. 
When FPROC is executed, QUERY 
prompts for three LAST-NAME 
values 



You must supply a value for each 
null value in the procedure. You 
can use a known invalid response 
if you do not want to find the 
third name. 



>CREATE CHECK, FIND CREDIT- RATING ILT 5 END 



> FIND CHECK 

USING SERIAL READ 

2 ENTRIES QUALIFIED 

> CREATE NAMES, REPORT 

» D.> LAST-NAME, 20 

»// 

>REPORT NAMES 



»pause; 

» END 



The procedure named CHECK is 
handy each time you want to list 
the names of customers with low 
credit ratings. 



The NAMES report procedure 
can also be used repeatedly. 



MCFALL 
CELERY 



NOTE 

It is sometimes convenient to leave the END out of the procedure. 
When it is executed, QUERY prompts for the missing END. 
You can then enter special sort or output control statements to 
vary the report and its output parameters. 



5-4 



CREATE 



To create a procedure in an MPE ASCII file and enter it in the Proc-file, follow the example 
below. 



Use EDIT/3000 to create the 
procedure. 



:EDITOR 



HP32201X.4.3B EDIT/3000 WED, JAN 1 4> 1976, 10:48 AM 
/A 

1 FIND 

2 CUSTOMER. ACCOUNT IS 

3 END 

4 // 



/K FIFILE 
/E 



Keep the file. 
Exit the Editor. 



END OF SUBSYSTEM 
:RUN QUERY. PUB. SYS 



Run QUERY. 



HP32216A.03.00 QUERY/3000 WED> JAN 14, 1976, 11:39 AM 



0UERY/3000 READY 
>B=STORE 

PASSWORD = >> CLERK 
MODE = >>1 
> PROC-FILE=PROCX 

FILE DOES NOT EXIST, BEING CREATED 

> CREATE FIPROC, FIFILE 

FIND 

CUSTOMER. ACCOUNT IS 
END 

> FIND FIPROC 

WHAT IS THE VALUE OF - ACCOUNT 
» 1 1 1 1 1 1 1 1 
NO ENTRY 



Define the environment. 



Specify a Proc-file. 

Use the CREATE command with 

a procedure name and the 

file name, (in this example, 

FIPROC and FIFILE 

respectively). 



0 ENTRIES QUALIFIED 
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CREATE SPACE 



Reports the number of unused records left in the current Proc-file. 



The form of the CREATE SPACE command is 



CREATE 



SPACE 



For example, 



CR SPACE 



Each stored procedure starts on a record boundary and extends through as many records as 
necessary. Generally, one record is sufficient for most UPDATE and FIND commands, while 
long REPORT commands may take more than one record. 

If you want to know how much space is left in the current Proc-file before you begin creating 
another procedure, you can use the CREATE SPACE command to find out. 



EXAMPLE 



> CREATE SPACE 
F!ECORDS = 109 
> DESTROY SETUP 
> CREATE SPACE 
RECORDS = 110 



The Proc-file has 1 09 unused records. 



If the SETUP procedure is deleted, 
the Proc-file has 110 unused records. 
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Lists individual commands stored on the Proc-file as named procedures. 



The form of the DISPLAY command when used for this purpose is 



DISPLAY \ 

D 



procedure name 



,m [,n] 
, filename 



For example, 

DPROCA, 2, 4. 
procedure name^m 



or 



DISPLAY GETIT 
procedure name 



or 

DISPLAY PROCZ, FILEB 
procedure name filename 

where procedure name 

m and n 



filename 



is the name of a command (see table 5-1) stored 
as a procedure on the current Proc-file. 

are the first and last lines of the procedure 
(respectively) to be displayed, m must be an 
integer smaller than or equal to n. m must be 
an integer greater than or equal to 1. 

is the name of an MPE ASCII file in which you 
want to write the procedure. 



When you use this command, QUERY searches the current Proc-file for the named proce- 
dure. If the procedure does not exist or if no Proc-file has been declared, you are so informed 
and prompted for another command. 

If the procedure does exist, it is listed along with line numbers for you to reference when 
using the ALTER command to edit the procedure. If line numbers (m,n) are included in 
the DISPLAY command, only those lines specified will be listed. 



DISPLAYING TO A FILE 



If a filename is included in the command, QUERY writes the procedure statements (exclud- 
ing line numbers and header which appear as part of the procedure listing) to the specified 
file. The entire procedure must be transferred. Any existing information in the file is 
overwritten. 
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If you have access to the group files and filename does not exist in your log-on group, 
QUERY creates the file and saves it using filename as the formal designator (name of the 
file). The message 

FILE DOES NOT EXIST, BEING CREATED 

is printed when this situation occurs. The file size will be 200 records. The maximum 
Proc-file record size is 125 words. 



EXAMPLES 



> DI SPLAY FIPP-OC.> FISET 
>D I SPLAY FIPROC 



The FIPROC procedure is 
written to file FISET. 



PROCEDURE: FIPROC 



FIPROC is listed on the 
terminal. 



001 
002 
003 



FIND 

CUSTOMER. ACCOUNT IS 
END 



>0=LP 
> DI5 F101 
> 0=TERM 
>DIS F101 



If OUTPUT==LP, the list is 
printed on the QSLIST device. 
If OUTPUT=TERM, it is 
printed on the terminal. 



PROCEDURE: F101 



The procedure lines are 
numbered. 



001 
002 
003 



FIND CHAIN 

CUSTOMER. ACCOUNT, SALES. ACCOUNT 
IS END 




A single line or a range of lines 
can be displayed. 



PROCEDURE: F101 



002 CUSTOMER. ACCOUNT.^ SALES . ACCOUNT 
00 3 IS END 




If a specified file does not 
'exist, QUERY creates one. 



> DI SPLAY F10I.>SAVEP X 
FILE DOES NOT EXIST* BEING CREATED 
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DISPLAY LIST 



Lists the names of all procedures in the current Proc-file. 



The form of the DISPLAY LIST command is 

i display] 



D 



LIST 



For example, 

DISPLAY LIST 

If you enter this command, QUERY prints the names of all procedures currently in the 
Proc-file. If no Proc-file has been declared, you are so informed and prompted for another 
command. 

If you have specified OUTPUT=LP (see the OUTPUT= command), the DISPLAY command 
prints information on both the QSLIST device and the terminal in session mode. In this case, 
the procedure listing includes a header containing the procedure filename and the date you 
display the procedure names. 



EXAMPLES 

>DI SPLAY LIST 



REPORTX F101 
FPROC CHECK 

>P=MANPROC 
> OUTPUT=LP 
>D I SPLAY LIST 



Fl 



LPS 



FIPROC 
NAMES 



UPDl 



REPORTZ 



FN AMES 



CHANGE 



If OUTPUT=LP, DISPLA Y LISTS lists on 
both the terminal and the QSLIST device. 



REP4 



ZAP 



BREP 



Listing from QSLIST. 

\ 

F'f- OCtDUH^t f^ ILt: MAnPWOC. IMAGE .DATAMbT 



WHD» JAN 1^, 1976 



f- 1 



LP3 



UPDl 



PtPA 



ZAP 



HREP 
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Inserts, replaces, and deletes lines of a procedure stored in the current Proc-file. 



The form of the ALTER command is 



I 



ALTER 



A 



procedure name 



For example, 



ALTER REP22 



where 



procedure name 



is the name of a procedure stored on the 
current Proc-file. 



When you enter the ALTER command, QUERY prompts you for insert, replace, and delete 
statements by printing ». Each statement operates on a line or range of lines in the proce- 
dure. In the statement descriptions that follow, m is the first line number in the range and n 
is the last line number, n must always be greater than or equal to m and m must be greater 
than or equal to 1. Neither m nor n may exceed the total number of lines in the procedure. 

Once you enter the ALTER command, you must do your editing sequentially from lower 
numbered lines to higher numbered lines. You cannot go back to a line which precedes the 
ones you are currently editing without exiting the ALTER command and entering another 
one. This technique is illustrated in the examples which follow. 

If an error occurs after a statement is entered, an error message is printed and QUERY 
prompts you for another ALTER statement. 

You can abort the command at any time by entering Control Y (Y'^). If you do this, the 
procedure remains unchanged. Always terminate the command with /E if you want to save 
the results of your changes. 

The four statements you can use in response to an ALTER prompt are: the insert, replace, 
delete, and end statements. 

Lines which are inserted, or which replace current lines, are not checked for accurate syntax 
until the procedure is executed. Similarly, if line deletion causes the procedure to have bad 
command syntax, it will not be detected until the command is executed. 
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INSERT STATEMENT 

The insert statement inserts lines into the procedure. 



The form is 
»/I,m 
» line 
» line 



Note: QUERY prompts for each 
statement and line with ». 



For example, 
»/I,2, 



m 

» FIND POTATO = RUSSET END 



line 



where 



m 



line 



is the number of a procedure line after which you 
want to insert some statements. 

is the new line you want to insert. 



The lines which follow the insert statement are inserted into the procedure following line 
number m. You cannot insert lines in front of the first procedure line. For example, the 

insert statement: 

>ALTER Fl 
1 

» STOCK# IS "" AND 
» LASTSHIPDATE IS "" 
»/E 

changes the procedure Fl from: 

001 FIND 

002 END 



to 

001 FIND 

002 STOCK# IS "" AND 

003 LASTSHIPDATE IS 

004 END 



To indicate you do not want to insert any more lines, enter another ALTER statement 
beginning with a slash. 
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REPLACE STATEMENT 

The replace statement deletes the line or range of lines specified and replaces them with the 
lines following the replace statement. 



The form is 

»/R, m [,n] 

(current lines m through n are listed) 
» line 
» line 



For example, 



»/R2, 3.* 

"^-^ m 


—n 


HOURS 


<<)). 


DATE 


"741022"; 


»HOURS = 


"14";— 

— line 


»DATE 


"741101";^ 

^ine 


»STATUS = 


"OK";_. 

line 



where m is the number of the first procedure line 

which you want to replace. 

n is the number of the last procedure line you 

want to replace. If n is not specified, only 
line m is replaced. 

line is the new line you want to replace the 

existing line. 

The example shown above changes the procedure UPl from: 

001 UPDATE REPLACE, 

002 H0URS=""1 

003 DATE="74J1022"; 

004 END 



Note: QUERY prompts for 
each statement and line with ». 



to 



001 UPDATE REPLACE.. 

002 H0URS="14"; 

00 3 DATE="741 101"; 

004 STATUS="OK"; 

005 END 
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DELETE STATEMENT 

The delete statement deletes the line or range of lines specified. 



Note: QUERY prompts for 
each statement with ». 



For example, 

»/D, 2 4 

m n 

where m is the first line you want to delete. 

n is the last line you want to delete. If n is 

not specified, only line m is deleted. If n 
is specified, the range of lines from m to n 
is deleted. 

The deleted lines are listed so that you know exactly what you deleted. You cannot delete 
a procedure from the Proc-file using a delete statement. If you try to delete all the lines in 
the procedure, an error message is printed. To delete the entire procedure, you must use 
the DESTROY command. 



The form is 

»/D, m [,n] 



EXAMPLE 



The delete statement: 

>ALTER REP4 
» /D> 3.>4 
Sl.r STOCK* 
S^LASTSHIPDATE 
»/E 

changes the procedure named REP4 from: 



Note: QUERY lists the deleted lines, 
to: 



001 REPORT 

002 HI, "MONTHLY SHIPMENTS", 25, SPACE A2 

003 SI, STOCK* 

004 S,LASTSHIPDATE 

005 GI, STOCK*, 15 

006 D1,LASTSHIPDATE, 25 

007 END 



001 REPORT 

002 HI, "MONTHLY SH I PM ENTS 25, SPAC E A2 

003 Gl, STOCK*, 15 

004 D1,LASTSHIPDATE, 25 

005 END 
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END STATEMENT 

The end statement terminates the ALTER command. It must always appear as the last 
statement of the command. 



The form is 
»/E 



QUERY continues to prompt you for insert, delete, or replace statements until you enter /E. 
If the ALTER command is terminated using Control Y the entire command is ignored and 
the procedure remains in its original state. 

EXAMPLE 

>D REPORTY To alter REPORTY, first display it. 



PROCEDURE; REPORTY 

001 REPORT 

002 HK"AS OF:", 6 

003 HI, DATE, 15 

004 H2, "BOBO'S MERCANTILE", 45 

005 HI, "PAGE", 69 

006 H1,PAGEN0,7I 

007 DI,ST0CK#,36 

008 D1,LASTSHIPDATE,48,E2 

009 E2, "XX/XX/XX" 

010 EN D 

Insert a Sort statement after line 9. 

You cannot alter a line which precedes 
the last one altered. 



Terminate the command and then you 
can alter the line. 



Replace lines 2 and 3 with new Header 
statements. 



Delete lines 5 and 6. 



QUERY lists the deleted lines. 



Terminate the command and display the 
new REPORTY command. 

PROCEDURE: REPORTY 

001 REPORT 

002 HI, "TO DATE:", 6 

003 Hi, DATE, 20 

004 H2, "BOBO" S MERCANTILE", 45 

005 Dl, STOCK*, 36 

006 D1,LASTSHIPDATE,48, E2 

007 E2, "XX/XX/XX" 

008 S,LASTSHIPDATE 

009 END 



>ALT ER REPORTY 
»/I 




HI, "AS OF:' 
HI, DATE, I 5 
»H1,"T0 DATE 



»H1, DATE, 20 
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Deletes a procedure from the current Proc-file. 

The form of the DESTROY command is 
procedure name 



For example, 

DESTROY FANG 
procedure nam^ 

where procedure name is the name of a command stored on the 

current Proc-file as a procedure. 

This command deletes a procedure from the current Proc-file. If the Proc-file has not been 
declared, or if the named procedure does not exist on the Proc-file, QUERY so informs you 
and prompts you for another command. If the procedure does exist on the Proc-file, it is 
deleted. 



j DESTROY 
1 DE 



EXAMPLE 



>D I SPLAY LIST 



Fl F2 
> DESTROY UPS 
>D LIST 



Fl 



F2 



UPl UPS REP4 ZAP 

'Delete the UP2 procedure from the current Proc-file. 
UPl REP4 ZAP 
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Changes the name of a procedure in the current Proc-file. 



The form of the RENAME command is 

{RENAME I procedure name , new procedure name 

REN I 



For example, 



RENAME OPROC , NPROC 
/ 

old procedure name new procedure name 



where 



old procedure name 
new procedure name 



is the name currently associated with the 
procedure. 

is the name you want to use for the proce- 
dure in the future. See the CREATE 
command for naming rules. 



Both procedure names must follow the rules defined in the CREATE command description. 
An error message is printed if old procedure name does not refer to an existing procedure in 
the current Proc-file. 



> DI SPLAY LIST 

Fl F2 

> RENAME UPl^UPDl 
>DI SPLAY LIST 

Fl F2 

>REN F2jLP 
ILLEGAL NAME 
> REN F2.>LP3 
>D LIST 



UPl 



REP4 



ZAP 



Change the name of UPl to UPDl. 



UPDl 



REP4 



ZAP 



You cannot name a procedure LP, but LPS 
is allowed. 



Fl 



LPS 



UPDl 



REP4 



ZAP 
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Executes QUERY commands from a file instead of the standard input device. 

The form of the XEQ command is 

^^Q) filename [, NOD AT A] 



For example, 

XEQ CFILE,NODATA 

/ t 

filename option 



where filename 
NODATA 



is the name of an ASCII file containing 
commands and parameters. 

is an option. If specified, QUERY prompts 
for the command parameters when the com- 
mands are executed instead of reading them 
from the file. The prompt consists of two 
"greater than" symbols. 



When the XEQ command is entered, the specified file is read and the commands executed 
until an end-of-file or another XEQ command is encountered. Any command input is also 
read from filename unless the NODATA option is specified. When an end-of-file is reached, 
control returns to the original command input device (in session mode, the terminal, or in 
job mode, the job input device). 

Only the first 72 characters of each record are read. You may continue a command on the 
next record by entering an ampersand (&) as the last non-blank character in the current 
record. 

If an error occurs while opening the data base in session mode, the XEQ file is closed and 
you are prompted for a QUERY command at the terminsil. In job mode, the file is closed 
and QUERY terminates. 

An XEQ command within another XEQ file will close the first file and open the new one. 
The initial file is never reopened, that is, the XEQ performs as an end-of-file but transfers 
execution to the new file. 
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EXAMPLE 1 

In this example, an XEQ file called FISET is used to define a particular QUERY session 
environment. 

>XEQ FISET The FISET file contains these records: 

DEFINE DEFINE 
DATA- BASE = STORE 

PASSWORD = CLERK STORE 
MODE = 5 

DATA- SETS = S CLERK 
PROC-FILE = PROCX 

OUTPUT = TERM 5 
OUTPUT = TERM 
END OF XEQ FILE 

PROCX 
TERM 

QUER Y executes the DEFINE command and 
uses the other records as data in response to 
DEFINE command prompts. 

EXAMPLE 2 

This example illustrates how an XEQ file, PRXFIL, can be used to store and execute a pre- 
planned find-and-report sequence. It also illustrates how the FIND CHAIN command can 
be used to access two data sets. Here, information from CUSTOMER and SALES is used to 
prepare a bill. 

>XEQ PRXFIL, NODATA 

FIND CHAIN CUSTOMER. ACCOUNT, SALES. ACCOUNTS"- END 

WHAT IS THE VALUE OF - ACCOUNT 

>>2 

2 ENTRIES QUALIFIED 



The file PRXFIL looks like this: 

FIND CHAIN CUSTOMER, ACCOUNT, SALES. ACCOUNTS"" END 
REPORT BILL 

Since you want to be prompted for a value when the FIND CHAIN command containing a 
null value is called, you use the NODATA option in the XEQ command. Note that if 
REPORT were called directly from the file, XEQ NODATA would prompt you for report 
statements instead of reading them from the file . Therefore, the REPORT command is stored 
as a procedure, BILL, in the current PROC-FILE, and is initiated from PRXFIL after the 
FIND CHAIN command. 
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EXAMPLE 2 (continued) 



The procedure BILL contains the following statements 



REPORT 

H1,"B0B0'S MERCANTILE", 43, SPACE A4 
H2, "ACCOUNT 
H2, ACCOUNT, 22 

H2, "BILLING DATE: " ,59, SPACE A2 

H2, DATE, 69 

H3, FIRST-NAME, 14 

H3, INITIAL, 16 

H3 , LAST-NAME, 33 

H4, STREET-ADDRESS, 31 

H5, CITY, 18 

H5, STATE, 20 

H5, ZIP, 27, SPACE A2 

H7, "PURCHASE DATE", 14 

H7, "PURCHASE", 65, SPACE B3 

H8, "TOTAL", 65, SPACE A2 

D,PURCH-DATE,10,E1 

El ,"XX/XX/XX" 

R4, LOAD, QUANTITY 

R4, MULT, PRICE 

R4, ADD, TAX 

D,R4,65,E2 

E2,"$SS,$$S.99" 

R0,ADD,R4 

TF, "TOTAL DUE", 15, SPACE B2,SKIP A 

TF,R0,65,E2 

S, PURCH-DATE 

END 



The resulting report is shown in figure 5-1. 
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EXAMPLE 2 (continued) 





BOBO'S MERCANTILE 




ACCOUNT #: 2 




BILLING DATE: 06/19/79 


HARLEY W LOND 
1362 16TH AVE 
SAN FRANCISCO, CA 


94122 




PURCHASE DATE 




PURCHASE 
TOTAL 


79/05/05 




$418.22 


TOTAL DUE 




$418.22 



Figure 5-1. Billing Report From an XEQ File. 
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QUERY/3000 MESSAGES 



All messages to the user are output to the device specified as $STDLIST for the operating 
system. This is normally a terminal for a session, or the line printer for a job. Messages fall 
into two categories — those recognized by QUERY such as incorrect command format, and 
those passed to QUERY from the IMAGE/3000 routines called by QUERY. Messages in the 
first category are described in separate tables for each command to which they apply (tables 
6-2 through 6-16), or in table 6-1 which contains general messages. IMAGE error messages 
are described in Appendix A of the IMAGE Reference Manual. In some cases, however, the 
IMAGE messages are exceptional and may require the aid of HP support personnel if the 
conditions persist. They are listed in Appendix C of this manual. 



Table 6-1. General Messages 



MESSAGE 


MEANING 


ACTION 


<CONTROL Y> 


You have entered Control Y. 


Wait for QUERY prompt. 


DATA RAQP Rl IQY HO VOi 1 

WISH TO WAIT (YES OR NO)? 


Data base opened with access 
modes 1 and 5 with other 
users currently accessing the 
data base. 


Reply NO to ignore current 
command. Reply YES to be 
placed in a wait queue until 
all other users in the queue 
have accessed the data base. 


EOD ON COMMAND 
INPUT FILE 


An :EOD, :JOB, :EOJ, or 
:DATA record has been 
encountered. 


None. 


rA 1 AL bnnUn: 
QUERY TERMINATED 


Unrecoverable error has 
occurred during QUERY 
operation. 


Consult with the data base 
administrator or the system 
manager. 


FILE OPEN ERROR code 


File error occurred while 
MPE opening file on your 
behalf, code is an MPE 
file systenfi code describing 
the error. 


See the MPE Commands Ref- 
erence Manual for description 
of the File Information Dis- 
play which has been printed. 


FILE READ ERROR corfe 


Physical error during Proc- 
file read operation, code 
is an MPE file system code. 


Same as FILE OPEN ERROR 
above. 


FILE WRITE ERROR corfe 


Physical error during file 
write operation. \f code = 
0, end-of-file was detected. 


Same as FILE OPEN ERROR 
above. 


ILLEGAL SOURCE DIGIT IN 
CONVERSION CVAD - 
REPLACED WITH ZERO 


Routine which converts 
ASCII numeric strings to 
packed decimal format has 
detected an illegal digit. 
Digit is converted to zero 
and processing continues. 


None. 

■— 1 
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SECTION 



VI 



Table 6-1. General Messages (Continued) 



MESSAGE 


MEANING 


ACTION 


INPUT TOO LONG 


Command just entered exceeds 
698 characters. 


Re-enter the command with 
fewer characters if possible. 


INVALID COMMAND 


QUERY does not recognize 
the command. 


Consult the command 
description for proper format 
ano \in session moae/ re-enter 
the command. 


PROCEDURE NAME NOT 

r U U IM U 


Named procedure is not in 
the directory for the current 
Proc-file. This message may 
also appear if the command 
syntax is incorrect. 


Correct the procedure name, 
declare a different Proc-file, 
or correct the command 
syntax. 


PROC-FILE BUSY 


Proc-file is currently being 
accessed by another user. 


The command using the 
Proc-file is ignored. Try 
again later. 


PROC-FILE NOT DECLARED 


Command has referenced a 
procedure before a Proc-file 
has been declared. 


Use the PROC-FILE= 
command to declare a 
Proc-file. 


QUERY/3000 READY 


QUERY successfully 
loaded and ready to accept 
a command. 


Wait for the ^ prompt. 
Then enter a command. 


READ ERROR FROM 
COMMAND INPUTFILE 


Physical read error occurred 
while reading from the 
command input file. 


Check the input device and 
try entering the command 
again. Consult with MPE 
system manager. 


WRITE ERROR TO COMMAND 
LISTFILE 


Physical write error 
occurred while writing to 
the standard list device 
(known as $STDLIST to 
MPE). 


Check the output device and 
try the current command 
again. Consult with MPE 
system manager. 



DEFINE command error messages can be found with other commands. If an error 
occurs when responding to a DEFINE commsind prompt, look at the table for the 
command corresponding to that prompt. For example, the DATA-BASE= » 
prompt messages Eire included in table 6-4, DATA-BASE= Command Messages. 
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Table 6-2. ALTER Command Messages 



MESSAGE 


MEANING 


ACTION 


END PROCEDURE DATA 


Line number referenced In an 


Command terminates. Re- 




insert, replace, or delete state- 


enter with the correct 




rncMX IS grcaier Tnan ine Tinai 


statement number. 




siaiemcnT nurnoer ot ine 






procedure beinQ altered. 




EXPECTED A '/ 


Comma missing from the 


Re-enter the statement. 




alter statement. 




ILLEGAL NAME 


Procedure name referenced 


Use DISPLAY LIST to 




exceeds eight characters. 


determine the correct 




contains an illegal character, 


procedure name. Re-enter 




or consists of a reserved 


command with correct 




word. 


name. 


INPUT ERROR 


• No line number in an 


Re-enter the statement 




insert, delete, or replace 


correctly. 




statement (for example. 






/R,) 






# Rpainnina linp nurnhpr 

* L^^M 1 IIIIIIIM lltlw IIUIII L/C 1 






y 1 cci LCI Liiciii ciiuiiiy 






statement number (for 






example, /R,5,3) 






Ronirtnmn lino mimt^ot* 
^ Dc^illllillvJ lillc iiuiliucf 






referenced in statement 






less than ending line 






number of previous 






statement (for example. 






/R,2,4/D,3) 






• Alter statement does 






nnt ctart w/ith /I /R 
IIUL sLdlL VVILII / I, / n. 






/u, or /t 






• Illegal character entered 






• /R or /I entered with no 






aUUIIIOrial IIDcS \TOr 






example, /n,'* /u,o/ 




INPUT TOO LONG 


Combined length of 


Shorten the statement 




coniinueu lines \iines 


and re-enter the command. 




ooriricctcu uy ot cnaracier/ 






1 Idb CA<.«CC(JCU £.sJ\J \jl tat aKfLxSl o. 




NUMERIC VALUE ERROR 


Line number contains too 


Re-enter statement with 




many digits or an illegal 


correct line number. 




character. 




PROCEDURE CANNOT BE 


You have attempted to 


To delete procedure, use 


DELETED BY ALTER 


delete procedure line by 


the DESTROY command. 




line using ALTER. 






Procedure is not changed 






and command terminates. 
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Table 6-2. ALTER Command Messages (Continued) 



MESSAGE 


MEANING 


ACTION 


PROC-FILE BUSY, DO YOU 
WISH TO WAIT (YES OR NO)? 


Proc-file being accessed by 
another user. 


Reply NO to abort the 
command. Reply YES to be 
placed in wait queue until 
all users ahead of you in 
queue have accessed the file. 


PROC-FILE OVERFLOW, 
INPUT TERMINATED 


Procedure currently being 
altered has overflowed 
the available space left on 
the Proc-file. Part of 
procedure may be lost. 


List procedure using 
DISPLAY command before 
attempting to execute it. 


1 READ ) 
SCRATCH FILE ^ > 
1 WRITE \ 

ERROR code 


Physical read/write error 
occurred in a QUERY 
scratch file. File not 
accessible to users, code 
is an MPE file system code. 


See FILE OPEN ERROR 
in table 6-2. Try command 
again. 


Table 6-3. CREATE Command Messages 


MESSAGE 


MEANING 


ACTION 


DIRECTORY OVERFLOW, 
PROCEDURE REJECTED 


Current Proc-file directory 
is full and cannot accept 
more procedures. 


Delete existing unused 
procedures on current Proc- 
file or build and declare 
another one with PROC- 
FILE= command. 


DUPLICATE PROCEDURE 
NAME 


Procedure name already 
exists on the current 
Proc-file. 


Create the procedure again 
with a different name. 


EXPECTED A ',' 


Comma must follow the 
procedure name. 


Re-enter the command. 


FILE NOT TYPE ASCII 


File referenced is not an 
ASCII file. 


Re-enter the command 
using the name of an ASCII 
file. 


ILLEGAL NAME 


Procedure name exceeds 
eight characters, contains 
an illegal character or 
consists of a reserved word. 


See the CREATE command 
(Section V) for naming 
rules. Re-enter command 
with correct name. 


INPUT ERROR 


Input line contains an 
illegal character or input 
line exceeds 250 
characters. 


Shorten line if possible 
and re-enter it. 



6-4 



Table 6-3. CREATE Command Messages (Continued) 



MESSAGE 


MEANING 


ACTION 


PROC-FILE BUSY, DO YOU 
WISH TO WAIT (YES OR NO)? 


Proc-file being accessed by 
another user. 


Reply NO to abort the 
command. Reply YES to be 
placed in wait queue until 
all users ahead of you in 
queue have accessed the file. 


PROC-FILE OVERFLOW, 
INPUT TERMINATED 


Procedure being entered 
is too large for remaining 
space in Proc-file. Part of 
procedure that fits is 
stored. 


List procedure with 
DISPLAY command to 
determine how much was 
saved. 


RECORDS = XXX 


IVIessage printed in response 
to CREATE SPACE, xxx 
is number of unused records 
remaining In Proc-file. 


None. 



Table 6-4. DATA-BASE= Command Messages 



MESSAGE 


MEANING 


ACTION 


BAD DATA BASE REFERENCE 


Data base name is invalid 
or the account or group 
specified does not exist. 


Re-enter command with 
correct names. 


DATA BASE IN USE 


Data base is currently being 
accessed and cannot be 
opened with exclusive 
access mode. 


Change mode or try later. 


DATA BASE OPEN 
EXCLUSIVELY 


Data base is currently 
being accessed by another 
user with exclusive access 
mode. 


Wait until other user 
closes the data base and 
try again. 


DATA BASE OPEN IN 
ANOTHER MODE 


Data base is currently being 
accessed in an access mode 
which is incompatible with 
the one specified. 


Try another mode or try 
again later. (See Section 1 
for QUERY environments/ 
compatible modes.) 


DATA BASE REQUIRES 
CREATION 


Data base root file exists, 
but files containing data 
sets do not. 


Run the IMAGE/3000 
program DBUTIL in 
CREATE mode to create 
the data base. 


EXPECTED A '=' 


Command does not include 
an equal sign (=). 


Re-enter the command. 


ILLEGAL NAME 


Data base name referenced 

contains an illegal character 
or more than 24 characters. 


Re-enter command with 
correct name. 



6-5 



Table 6-4. DATA-BASE= Command Messages (Continued) 



MESSAGE 


MEANING 


ACTION 


INVALID MODE 


Response to the MODE= 
prompt is not an integer 
from 1 to 8. 


If prompted, re-enter mode. 
Otherwise re-enter the 
command. 


INSUFFICIENT VIRTUAL 
MEMORY 


QUERY cannot obtain 
necessary system disc 
space (virtual memory) 
to create table and work 
space required to access 
the data base. 


Try again later. 


NO SUCH DATA BASE 


Referenced data base does 
not exist or you did not 
include the account or 
group name. 


Re-enter the command with 
the correct data base name 
or append a group or 
account and try again. 


OUTMODED ROOT FILE 


Data base root file was 
created using a different 
version of the IMAGE/ 
3000 software, current 
QUERY software is not 
compatible with this file. 


You may need to dump the 
data base to tape using the 
IMAGE/SOOp DBUNLOAD 
program, recreate the data 
base root file using a differ- 
ent version of DBSCHEMA 
and DBUTIL, and reload 
the data base using DBLOAD. 


PASSWORD ERROR 


Password entered in 
response to PASSWORD= 
prompt either contains 
more than eight characters 
or does not allow at least 
read access to one or more 
data sets in the data base. 


If prompted re-enter the 
password. Otherwise, re- 
enter the command. 


SECURITY VIOLATION 


MPE file security has been 
violated (for example, a 
user with read access 
attempts to open a file 
with write access.) 


Try another mode or log-on 
account or ask the data base 
administrator for help. 


UNABLE TO ACCESS DATA 
BASE IN THIS MODE, m, n 


Root file cannot be opened 
with the access options 
required for the specific 
MODE, m is the list of 
required options 
(AOPTIONS) and /7 is the 
list of options granted by 
MPE file system, {m, n are 
integers) 


Ask the data base admini- 
strator for help. 
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Table 6-5. DATA-SETS= Command Messages 



MESSAGE 


MEANING 


ACTION 


EXPECTED A '=' 

EXPECTED A ',' 

ILLEGAL DATA SET NAME 
name 


Command does not include 
an equal sign (=). 

Data set names in list must 
be separated by commas. 

Either you cannot access 
the data set named name 
because your password is 
not sufficient or name 
does not exist in the data 
base being accessed. 


Re-enter the command. 

Re-enter the command. 

Declare a different password 
if possible or use a different 
data set name. 


Table 6-6. DESTROY Command Messages 


MESSAGE 


MEANING 


ACTION 


ILLEGAL NAME 

PROC-FILE BUSY, DO YOU 
WISH TO WAIT (YES OR NO)? 


Referenced procedure 
name contains more than 
eight characters or contains 
an illegal character or 
consists of a reserved word. 

Proc-file is being accessed 
by some other user. 


Use DISPLAY LIST to 

determine the correct 
procedure name. Re-enter 
the command with 
correct name. 

Reply NO to abort the 
command. Reply YES to 
be placed in a wait queue 
until all users in front of 
you in the queue have 
accessed the file. 


Table 6-7. DISPLAY Command Messages 


MESSAGE 


MEANING 


ACTION 


EXPECTED A ',' 

FILE DOES NOT EXIST, 
BEING CREATED 

ILLEGAL NAME 


Command is missing a 
comma. 

filename specified in the 
command does not exist in 
log on group. File is created 
by QUERY and saved using 
filename as the formal 
designator. File size is 200 
records. 

Referenced procedure 
name contains more than 
eight characters, contains an 
illegal character, or consists 
of a reserved word. 


Re-enter the command. 
None. 

Use DISPLAY LIST to 

determine the correct 
procedure name. Re- 
enter the command 
with correct name. 
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Table 6-7. DISPLAY Command Messages (Continued) 



MESSAGE 


MEANING 


ACTION 


INPUT ERROR 


• The beginning line number 
is less than 1 (for example, 
DISPLAY F101,0,3) 

• The beginning line number 
is greater than the ending 
line number (for example, 
DISPLAY F101,4,2) 


Re-enter the command. 


NUMERIC VALUE ERROR 


A line number contains an 
illegal character or too many 

characters (for example, 
DISPLAY F101,2A,3) 


Re-enter the command. 


PROC-FILE BUSY, DO YOU 
WISH TO WAIT (YES OR NO)? 


Proc-file is being accessed 
by another user. 


Reply NO to abort the 
command. Reply YES to be 
placed in a wait queue until 

all UocI b dllcdU KJ\ yuu III 

queue have accessed the file. 


SCRATCH FILE WRITE ERROR 
code 


Physical write error has 
occurred in a QUERY 
scratch file. File is not 
accessible to users, code 

is an MPE file system code. 


See FILE OPEN ERROR 
in table 6-2. Try command 
again. 


Table 6-8. FIND Command Messag 


es 


MESSAGE 


MEANING 


ACTION 


BROKEN CHAIN POINTERS 


You have read only access 
and are sharing data base 
with user who is making 
structural changes to it. 


Re-enter the command. 


COMMAND TABLE OVERFLOW 


FIND command contains 
more than 50 logical 
relationships. 


Re-enter command with 
fewer relationships. 


DATA BASE NOT DECLARED 


FIND command has been 
entered prior to declaring 
the data base to be 
accessed. 


Use the DEFINE or 
DATA-BASE= command 
to declare the data base. 


DATA ITEM VALUE TOO 
LONG 


Data item value entered 
exceeds 500 characters or 
the maximum allowable 
length for the data item 
type defined. 


Re-enter command with 
a uiTTcrcni vaiue. 


ENTRIES RETRIEVED 
EXCEEDS 65000 


Only 65000 entries can be 
selected as a result of a 
single FIND command. 


Re-enter command with 
stricter selection criteria or use 
the entries already selected. 
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Table 6-8. FIND Command Messages (Continued) 



MESSAGE 


MEANING 


ACTION 


XXX ENTRIES QUALIFIED 


XXX Is the number of entries 
selected by the FIND 
command. 


None. 


EXPECTED A CONNECTOR 
OR 'END' 


Command is missing a 
logical connector (AND 
or OR) or a terminating 
"END", or an ending quote 
is missing from a data item 
value. 


Re-enter command. 


EXPECTED A LITERAL VALUE 


Beginning or ending quote 
(") is missing from a data 
item value. 


Re-enter the command. 


'FIND' EXPECTED 


Procedure called from the 
Proc-file through a FIND 
procedure name command 
is not a proper FIND 
procedure. 


Use DISPLAY or DISPLAY 
LIST to determine the 
problem and re-enter the 
command with the correct 
procedure name. 


ILLEGAL DATA ITEM NAME 
name 


Data item name does not 
belong to the data set 
specified or to the data 
base currently being 
accessed. 


Re-enter the command 
with a valid data item 
name. (Use the FORM 
command to determine 
the valid data item name.) 


ILLEGAL DATA SET NAME 
name 


Data set called name does 
not belong to the data base 
currently being accessed. 


Re-enter the command 
with a valid data set name. 
(Use the FORM command 
to determine the valid set 
names.) 


ILLEGAL ITEM LENGTH 


Data item being referenced 
is not of the proper size and 
type to be processed by 
QUERY. 


See Section 1 for descrip- 
tion of acceptable data 
types. 


INPUT TOO LONG - 
TRUNCATED 


Data item value entered is 
longer than the defined 
length of the data item. 
Value is truncated on the 
left and stored. 


None. 


INVALID CONNECTOR OR 
TERMINATOR xxxx 


QUERY expected a logical 
connector (AND or OR) 
or "END", xxxx is the 
offending character string 
appearing in place of the 
expected string. 


Re-enter the command. 


INVALID # VALUES FOR 
RELATIONAL OPERATOR 


Multiple data item values 
may follow only the 
"equal" or "not equal" 
relational operators. 


Re-enter the command 
changing either the 
relational operator or 
values. 
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Table 6-8- FIND Command Messages (Continued) 



MESSAGE 


MEANING 


ACTION 


INVALID RELATIONAL 


A relational operator other 


Re-enter command after 


OPERATOR 


than the acceptable ones 


consulting table 3-1 and 




shown in table 3-1 has been 


rpolarino thp inrnrrprt 




entered. 


operator. 


NO ENTRY 


No entries were located 
which match the criteria 
specified in the FIND 
command. 


Enter next command. 


NON-NUMERIC IN REAL 


Non-numeric digit has 


Re-enter command with 


VALUE 


appeared in a real data item 
value. (This does not 
include values entered in 
scientific notation such as 


correct value. 


NOT ENOUGH SECTORS IN 


More data item values 


Re-enter the command 


QSKIB FILE 


appear in a FIND command 


with fewer data item 




than can be stored in a job 


values. 




temporary file known to 










PROCEDURE NAME TOO LONG 


Name of the procedure 


Re-enter the command with 




appearing in a FIND 


a valid procedure name. 




procedure name command 






is more than eight 






characters. 




RETRIEVAL FROM MORE 


FIND command has 


Determine the problem by 


THAN ONE DATA SET 


specified access to more 


using the FORM command 




than one data set or a 


and examining the FIND 




FIND CHAIN command 


command just entered. 




has specified access to 


Re-enter the command. 




more than one detail data 






set. 




( READ \ 

SCRATCH FILE \ \ 
1 WRITE 1 

ERROR code 


Physical error has occurred 
in a QUERY scratch file. 
File is not accessible to 
usprs rnrJp \^ an MPF filp 
system code. 


See FILE OPEN ERROR in 
table 6-2. Try command 
again. 


USING SERIAL READ 


QUERY must read each 


Wait for QUERY to 




record of the detail data set 


complete the search or 




without henpf it nf a ma^tpr 


LCri IIIIIICILC LlltJ UL/IIIIIICIIIU 




data set. 


with Control Y. 


WHAT IS THE VALUE OF 


FIND command contains a 


Supply a value for the 


name 


null data item value. 


data item called name. 
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Table 6-9. FORM Command Messages 



MESSAGE 


MEANING 


ACTION 


DATA BASE NOT DECLARED 


FORM command has been 
entered prior to declaring 
the data base to be 
accessed. 


Use the DEFINE or DATA- 
BASE= command to declare 
the data base name. 


ILLEGAL DATA ITEM NAME 
name 


Data item named name 
does not appear in the data 
base being accessed or is not 
accessible to you based 
ijnnn vnur oa^iivunrd 


Use the FORM command 
to determine the correct 
item or change your pass- 
word with the PASSWORD= 
command 

Vx\_/ 1 III IIMI IVhI* 


ILLEGAL DATA SET NAME 
name 


Data set called name does 
not belong to the data 
base currently being 
accessed or is not access- 
ible to you based upon 
your password. 


Same as previous message. 


Table 6-10. LIST Command Messages 


MESSAGE 


MEANING 


ACTION 


COMMAND TABLE 
OVERFLOW 


LIST command contains 
more than 10 logical 
relationships. 


Re-enter the command 
with fewer logical 
relationships. 


CONSTANT LITERAL TABLE 
OVERFLOW 


Number of data item values 
appearing in the entire 
LIST command has 
exceeded the capacity of 
the table used to hold them. 


Re-enter the command 
with fewer data item 
values. 


DATA BASE NOT DECLARED 


LIST command has been 
entered prior to declaring 
the data base to be 
accessed. 


Use the DEFINE or DATA- 
BASE= command to declare 
the data base. 


DATA ITEM VALUE TOO 
LONG 


Data item value entered 
exceeds 500 characters or 
the maximum allowable 
length for the data item 
type defined. 


Re-enter command with a 
different value. 


DUPLICATE ITEM IGNORED 
name 


Same data item has appeared 
more than once in the data 
item list. The first occurrence 
of the name is used and 
others are ignored. 


None. 
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Table 6-10. LIST Command Messages (Continued) 



MESSAGE 


MEANING 


ACTION 


EXPECTED A CONNECTOR 
OR 'END' 


Command is missing a logical 
connector (AND or OR) or a 
terminating "END" or a data 
item value is missing a 
terminating quote. 


Re-enter the command. 


ILLEGAL DATA ITEM NAME 
name 


Data item name does not 
belong to the data set 
specified or to the data 
base currently being 
accessed. 


Re-enter the command 
with a valid data item 
name. (Use the FORM 
command to determine 
the valid data item name.) 


ILLEGAL DATA SET NAME 
name 


Data set called name does 
not belong to the data 
base currently being 
accessed. 


Re-enter the command 
with a valid data set name. 
(Use the FORM command 
to determine the valid set 

names.) 


ILLEGAL ITEM LENGTH 


Data item being referenced 
is not of the proper size 
and type to be processed 
by QUERY. 


See Section 1 for descrip- 
tion of acceptable data 
types. 


ILLEGAL ITEM LENGTH - 
ITEM IGNORED 


Item length exceeds the 
maximum for the data type 
and is not printed. Item 
maximums are: U136, X136, 
Z20, and P20. 


See table 1-1 for maximum 
characters for each data 
type. 


INPUT TOO LONG - 
TRUNCATED 


Data item value entered is 
longer than the defined 
length of the data item. 
Value is truncated on the 
left for numeric type items 
and on the right for U and 
X type values. 


None. 


INVALID CONNECTOR OR 
TERMINATOR xxxx 


QUERY expected a logical 
connector (AND or OR) or 
"END", xxxx is the offend- 
ing character string appear- 
ing in place of the expected 
string. 


Re-enter the command. 


INVALID NUMERIC DIGIT 


Value input for a data item 
defined as type Z or P 
ouiiLdiiib ciii iiivdiiu ur riuii' 
numeric digit. 


Re-enter the command 
with the correct value. 


INVALID RELATIONAL 
OPERATOR 


A relational operator other 
than the acceptable ones 
shown in table 3-1 has 
been entered. 


Re-enter the command 
after consulting table 3-1 
and replacing the 
incorrect operator. 
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Table 6-10. LIST Command Messages (Continued) 



MESSAGE 


MEANING 


ACTION 


INVALID # VALUES FOR 
RELATIONAL OPERATOR 


Multiple data Item values 
may follow only the "equal" 
or "not equal" relational 
operators. 


Re-enter the command 
changing either the 
relational operator or 
values. 


NON-NUMERIC IN REAL VALUE 


Non-numeric digit has 
appeared in a real data item 
value. (This does not 
include values entered in 
scientific notation such as 
12.44E-H04.) 


Re-enter command with 
correct value. 


NUMERIC VALUE ERROR 


Numeric value input con- 
tains an illegal digit or the 
value exceeds the maximum 
value allowable for the 
data type. 


See table 1-1 description 
of data item types. Re- 
enter command with 
correct value. 


nh 1 nlbVAL rnUIVI IVlUnt 
THAN ONE DATA SET 


LIST command has 
specified access to more 
than one data set. 


use tne rwnivi commana xo 
determine the data base 
structure and examine the 
LIST command just entered. 
Re-enter the command. 


WHAT IS THE VALUE OF 
name 


LIST command contains 
a null data item value. 


Supply a value for the data 
item called name. 


Table 6-11. OUTPUT= Command Messages 


MESSAGE 


MEANING 


ACTION 


EXPECTED A '=' 


Equal sign is missing from 
the command. 


Re-enter the command. 


FILE NOT TYPE ASCII 


File equated to the QSLIST 
file (through an MPE :FILE 
command) is not an ASCII 
file. 


Check the file and re-enter 
the command. 


ILLEGAL NAME 


Name following OUTPUT= 
is not LP or TERM. 


Re-enter command. 


INVALID COMMAND 


OUTPUT=LP has been 
entered twice without an 
intervening OUTPUT= 
TERM. Command is 
ignored the second time 
it is entered. 


None. 


'QSLIST' DEVICE NOT 
AVAILABLE 


Device defined as QSLIST 
is in use by another 
process. 


Wait and try again later or 
use the terminal. 
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Table 6-12. PROC-FILE= Command Messages 



MESSAGE 


MEANING 


ACTION 


EXPECTED A '=' 


Equal sign {=) is missing 
from the command. 


Re-enter the command. 


FILE DOES NOT EXIST, 
BEING CREATED 


filename specified does not 
exist in the log-on group. 
File is created by QUERY 
and saved using filename 
as the formal designator. 
File size is 200 records. 


None. 


FILE NOT TYPE ASCII 


File referenced is not an 
ASCII file. 


Re-enter the command using 
the name of an ASCII file. 


FILE OPEN ERROR BAD 
RECSIZE 


ASCII file being declared 
as the Proc-file does not 
contain a record size of 
256 bytes. 


Declare a different Proc-file 
with the PROC-FILE= 
command. 


ILLEGAL NAME 


Proc-file name contains an 
illegal character. 


Re-enter command with 
valid name. 


OLD FORMAT ON PROCEDURE 
FILE 


File specified as the Proc- 
file does not have a file 
code of 1070. 


Ask the data base 
administrator for help. 


PROC-FILE TOO LARGE 


File being declared as 
Proc-file is larger than 400 
records. 


Re-enter command with a 
different file name. 


PROC-FILE TOO SMALL 


File being declared as the 
Proc-file is smaller than 
five records. 


Re-enter command with a 
different file name. 


UNABLE TO USE FILE 


The requested new Proc- 
file name is not large 
enough or is not an empty 
existing Proc-file. 


Re-enter command with a 
different name. 
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Table 6-13. RENAME Command Messages 



IVICdoMUC 




APTinW 


DUPLICATE PROCEDURE 
NAME 


New procedure name 
already exists on the 
current Proc-file. 


Re-enter command with a 
different procedure name. 


EXPECTED A ',' 


Comma must follow the 
old procedure name. 


Re-enter the command. 


ILLEGAL NAME 


Referenced procedure name 
contains more than eight 
characters, contains an 
illegal character, or consists 

U 1 d 1 CdCI VC\J VVLIf Ui 


See the CREATE command 
(Section V) for naming 
rules. Re-enter statement 
with correct name. 


PROC-FILE BUSY, DO YOU 
WISH TO WAIT (YES OR NO)? 


Proc-file being accessed 
by another user. 


Reply NO to abort the 
command. Reply YES 
to be placed in wait queue 
until all users ahead of you 
in queue have accessed the 
file. 



Note: For messages in table 6-14, if the statement in error is the first report statement, the 
command terminates. If it is not the first statement, you can re-enter the statement which 
raiised the error as dirented in the ACTION column. If the REPORT is a nrocedure. vou 



Table 6-14. REPORT Command Messages (Continued) 



MESSAGE 


MEANING 


ACTION 


AVERAGE OPTION 
ALREADY SPECIFIED 


The AVERAGE option has 
been entered twice for the 
same total statement. 


Re-enter the statement with 
a single AVERAGE option. 


AVERAGE OPTION NOT 
ALLOWED IN STATEMENT 


Statement other than total 
contains an AVERAGE 
option. 


Re-enter the statement with- 
out AVERAGE. 


COMMAND TABLE OVERFLOW 


REPORT command contains 
more than 100 statements. 


Re-enter report with fewer 
statements. 


CONSTANT LITERAL TABLE 
OVERFLOW 


Number of literal character 
strings appearing in all the 
header, detail, group, and 
total statements have 
exceeded the capacity of 
the table used to hold them. 


Revise the report and re- 
enter the command. 


CONTROL BREAK 
INCONSISTENCY 


Level numbers of total or 
group statements do not 
match properly with sort 
statement level numbers. 


Revise the report and 
re-enter the command. 


COUNT OPTION ALREADY 
SPECIFIED 


The COUNT option has 
been entered twice for the 
same total statement. 


Re-enter the statement with 
a single COUNT option. 


COUNT OPTION NOT 
ALLOWED IN STATEMENT 


Statement other than total 
contains a COUNT option. 


Re-enter the statement with- 
out COUNT. 


DATA ITEM NOT RETRIEVED 


Statement has referenced 
a data item that is not a 
member of the data entries 
selected by the last FIND 
command. 


Revise the statement and 
re-enter the command or 
statement or use the 
appropriate FIND command 
and re-enter the REPORT 
command. 


DUPLICATE EDIT 
STATEMENTS 


More than one edit state- 
ment with the same 
number has been entered. 


The second edit statement 
is ignored unless the 
REPORT is a procedure. If 
so, reply return to prompt. 
Alter the procedure later. 


DUPLICATE SORT DATA 
ITEM NAME 


More than one sort state- 
ment contains the same 
data item name. 


Revise report and re-enter 
the command. 


cut 1 iviMoiN cnnwn 


M numeric eciiT masK 
contains characters In the 
wrong order. 


Correct the mask and re- 
enter the edit statement. 


EDIT OPTION ALREADY 
SPECIFIED 


Statement contains more 
than one edit statement 
reference. 


Revise statement and re- 
enter it. 
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Table 6-14. REPORT Command Messages (Continued) 



MESSAGE 


MEAN[NG 


ACTION 


EDIT OPTION ERROR 


Edit statement reference is 
not between EO and E9 
Inclusive. 


Revise statement and re- 
enter it. 


EDIT OPTION NOT 
ALLOWED IN STATEMENT 


Edit statement has been 
referenced in a statement 
which contains a literal as 

a print element. 


Revise report and re-enter 
command. 


END-OF-FILE ON REPORT 
FILE 


There is not enough room 
left on the file to which 
the report is being written. 


Notify the system operator. 


END PRINT POSITION 
ERROR 


The end print position 
specified contains an 
illegal digit, is equal to zero, 
or is greater than the record 
size of the output device. 


Revise the statement and 
re-enter it. 


EXPECTED A LITERAL 
VALUE 


QUERY expected to find a 
literal character string in 
the statement. 


Revise the statement and 
re-enter it. 


EXPECTED A "," 


Comma is missing from a 
statement. 


Re-enter the statement. 


EXPECTED A";" 


More than one statement 
appears on the same line 
Wixnoux uciny Scpaidicu 
by a semicolon. 


Re-enter the statements on 
separate lines or separated 
uy seriii-cuions. 


HEADERS OVERFLOW A PAGE 


Header statements print 
more neaaer lines ot inior- 
mation (counting line 
skipping) than can fit on 
one output page. 


Revise the header state- 
menis ano re enier ine 
command. 


ILLEGAL ASCENDING/ 
DESCENDING CODE 


ASC or DES sort para- 
meter is missing or 
incorrectly spelled. 


Revise sort statement and 
re-enter it. 


ILLEGAL DATA ITEM 
NAME name 


Data item named name 
does not belong to data 
base currently being 
accessed, is not accessible 
to you based upon your 
password, or is not a 
member or the data set 
specified in the fully- 
qualified data item name. 


Use a different data item 
name or change your pass- 
word by using the 
PASSWORD= command. 


ILLEGAL DATA SET NAME 
name 


Data set called name does 
not belong to data base 
currently being accessed 
or is not accessible to you 
based upon your password. 


Use a different data set 
name or change your pass- 
word with the PASSWORD= 
command. Re-enter the 
command. 



MAY 1979 
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Table 6-14. REPORT Command Messages (Continued) 



MESSAGE 


McANINCa 


AU 1 lUN 


ILLEGAL DATA TYPE name 


Data type specified in a 
register statement is 
defined as U or X or is not 
R/7 where /? is a number 
from 0 to 9. name is the 
data item name. 


Revise the register statement 
and re-enter it. 


ILLEGAL ITEM LENGTH 


Data item being referenced 
is not of the proper size 
and type to be processed 
by QUERY. 


See Section 1 for description 
of acceptable data types. 


ILLEGAL NAME 


Name of a REPORT 
procedure exceeds eight 
characters or does not start 
with an alphabetic character. 


Re-enter command with 
correct name. 


ILLEGAL REGISTER 
OPERATOR 


Operator specified is not 
one of the valid register 
operators. 


See the register statement 
description in Section IV 

Revise statement and re- 
enter it. 


INCONSISTENCY BETWEEN 

/"iDTioM A M r\ cr\i"r cxatc 
Ur 1 lUlM AIMU bUI 1 b 1 A 1 t- 

MENTS 


Statement contains an 
edit statement label not 
used to define an edit 
statement. 


Revise statement and re-enter 
command. 


INVALID NUMERIC DIGIT 


A numeric value specified 
an illegal digit or the value 
exceeds the maximum 
value. 


Re-enter the statement. 


LEVEL ERROR 


Level number appearing in 
sort, group, or total state- 
ment is less than 1 , greater 

than ^ nr a hpaHpr nr 

detail statement level 

number is not between 1 
and 9 inclusive. 


Revise necessary statement 
and re-enter it. 


LITERAL TOO LARGE 


Literal character string 
exceeds the record size 
of the output device. 


Revise statement containing 
string and re-enter it. 


MORE THAN 5 FIELDS ARE 
BEING TOTALED 


Total statements reference 
more than five different 
data items. 


Revise necessary total 
statements and re-enter 
command. 


NON-NUMERIC IN REAL 
VALUE 


A non-numeric digit appears 
in the real value or exceeds 
the maximum allowable 
value. (Does not include 
values entered in scientific 
notation such as 12.44E-H04.) 


Re-enter the statement. 
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Table 6-14. REPORT Command Messages (Continued) 



MESSAGE 


MEANING 


ACTION 


NO. OF SORT ITEMS EXCEEDS 
LIMIT 


Number of sort items defined 
exceeds the maximum of 66. 


Revise report and re-enter 
command. 


NOT A REPORT PROCEDURE 


Procedure referenced in 
R EPO RT procedure name 
command is not a proper 
REPORT procedure. 


Use DISPLAY or 
DISPLAY LIST to find the 
correct procedure name. 


NOT A REPORT STATEMENT 


Statement is not recognized 
as a valid report statement. 


Revise statement and 
re-enter it. 


NUMERIC EDIT MASK 
EXCEEDS 20 CHARACTERS 


Numeric edit mask in an 
edit statement exceeds the 
maximum allowable 20 
characters. 


Revise the edit mask and 
re-enter the statement. 


OPTION ERROR 


Statement option is either 
illegal for the statement in 
which it appears, or the 
option is not recognized 
as valid. 


Revise statement and 
re-enter it. 


PARAMETER ERROR 


The output control state- 
ment UUTPUT-LP has a 
bad format. 


Revise statement and 
re-enter command. 


RECORD HAS NOT YET BEEN 

rUUNU 


REPORT command has 
been executed before a 
FIND command has been 
entered to select entries 
for reporting. 


Enter FIND command and 
re-enter ntrUn I command. 


REPORT CANNOT BE 
GENERATED DUE TO ERRORS 


REPORT command 
contains errors and will not 
generate a report. 


Revise report and re-enter 
command. 


REPORT INCOMPLETE - 
ITEM MISSING 


Indicates that some of the 
data items selected by the 
FIND command may have 
been deleted by some 
other user prior to 
executing the REPORT 
command. 


Re-enter the FIND and 
REPORT commands. 


SAME LINES HAVE CON- 
FLICTING REPORT OPTIONS 
label 


Like statements (such as 
multiple statements 
labeled D2) contain the 
same statement option 
(such as SKIP A). A state- 
ment option may appear 
only once for statements 
concerning the same report 
line, label is the statement 
type and level. 


Revise necessary statements 
and re-enter command. 
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Table 6-14. REPORT Command Messages (Continued) 



MESSAGE 


MEANING 


ACTION 


SCRATCH FILE , 


READ \ 
OPEN > 


Physical error has occurred 


See FILE OPEN ERROR in 


ERROR code 


write) 


during QUERY access of a 
scratch file. File Is not 
accessible to user, code is 
an MPE file system code. 


table 6-2. Try command again. 


SKIP OPTION ALREADY 


Skip option has been 


Revise statement and re-enter 


SPECIFIED 




specified twice in the same 
statement. 


command. 


SKIP OPTION ERROR 


Skip option is not SKIP A 


Revise statement and re-enter 






or SKIP B. 


command. 


SKIP OPTION NOT 


Header statements may 


Revise statement and re-enter 


ALLOWED IN HEADER 


not contain SKIP options. 


command. 


SORTLIB: message 


Error has occurred in one of 


Consult the SORT/3000 






the SORT/3000 procedures 


manual and try the command 






operating in behalf of 


again. 






QUERY, message is the 








SORT/3000 error message as 








specified in the SORT/3000 








Reference Manual. 




SORT LEVEL MISSING OR 


Group or total statements 


Revise necessary statements 


DUPLICATE label 




reference sort statements 
which either do not exist or 
appear twice in the REPORT 
command. For example, SI 
appears twice, or a total state- 
ment is labeled T3 when no 
S3 Statement exists, label is 
the statement type and level. 


and re-enter command. 


SPACE OPTION ALREADY 


A SPACE A or SPACE B 


Revise statement and re- 


SPECIFIED 




option appears twice in 
the same statement. 


enter command. 


SPACE OPTION ERROR 


SPACE option is not 


Revise statement and re- 






SPACE An or SPACE B n. 


enter command. 






where n is 1 to 5 inclusive. 




STATUS=%XXXXXX 


Hardware trap has occurred 


Consult with the data base 


P=%XXXXXX 




which was not enabled by 


administrator or system 


TRAP=%XXXXXX 


QUERY and cannot be hand- 


manager. 






led by QUERY. May be caused 








by hardware failure. QUERY 








terminates. XXXXXX is an 








octal number. Status is the 








status register, P is the P- 








register and TRAP is the 








MPE trap number. 
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Table 6-15. UPDATE Command Messages 



MESSAGE 


MEANING 


ACTION 


ATTEMPTED DELETION OF 
CHAIN HEAD 


Attempt has been made to 
delete a master search item 
value that still exists as a 
detail search item value in 
one or more linked detail 
data sets. 


If desired, delete detail 
entries first and then master 
entry. 


ATTEMPTED MODIFICATION 
OF A CRITICAL ITEM 


UPDATE REPLACE com- 
mand has attempted to 
change the value of a data 
item defined as a search or 
sort item. 


Enter next command or 
delete entire entry and add 
again with new value for 
search or sort item. 


ATTEMPTED MODIFICATION OF 
A READ-ONLY ITEM 


UPDATE REPLACE com- 
mand has attempted to 
modify a data item to which 
you have only read but not 
write access. 


You cannot modify the item 
unless you supply the 
appropriate password with 
the PASSWORD= command. 


AUTOMATIC MASTER 


UPDATE ADD command 
has attempted to add an 
entry to an automatic 
master data set. 


Enter another command. 


□ 1 IPCPR nVFRFI n\A/ 


1 Uidl Icliyill Ul all udLa llclllo 

to be modified in data set 
exceeds 2048 words and has 
overflowed the buffer used 
to hold them. If UPDATE 
REPLACE, the command 
terminates. 


^hnrtpn rTMTimanrl JinH rp- 

OIIUI Lcil ^1^1 1 II IICIi ILI allU IC 

enter it. 


DATA ITEM NOT RETRIEVED 


UPDATE REPLACE com- 
mand entered which 
references a data item that 
was not previously selected 
by a FIND command. 


Use FIND command and 
re-enter UPDATE command. 


DATA SET FULL 


No more entries can be 
added to the data set. 


Consult with the data base 
administrator. 


DATA SET NOT WRITEABLE 


Command entered attempt- 
ing to modify a data item 
in a data set which you are 
only allowed to read but 
not write. 


You must supply an appro- 
priate password or enter a 
different command. 


DELETE ALL RETRIEVED 
ENTRIES (YES OR NO)? 


Asks for confirmation of 
UPDATE DELETE com- 
mand just entered. 


Reply YES to delete all 
entries selected by the most 
recent FIND command. 
Reply NO to abort the 
command. 
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Table 6-15. UPDATE Command Messages (Continued) 



MESSAGE 


MEANING 


ACTION 


DUPLICATE ITEM IGNORED 
name 


Same data item has appeared 
more than once in an UP- 
DATE REPLACE command. 
Only first occurrence is used. 


None. 


EXPECTED A LITERAL VALUE 


Value in quotes following 
data item name is missing in 
an UPDATE REPLACE 
command. 


If prompted with > >, re- 
enter the data item name 
and value. Otherwise, re- 
enter the entire command. 


EXPECTED A "=" 


Equal sign (=) missing from 
an UPDATE REPLACE 
command. 


Re-enter command. 


EXPECTED A "," 


Comma is missing after UP- 
DATE ADD and before data 
set name. 


Re-enter command. 


EXPECTED A "; " 


Multiple data item name/data 
item value pairs exist in an 
UPDATE REPLACE com- 
mand and are not separated 
by semicolons. 


Re-enter command. 


FULL CHAIN FOR item/set 


Attempt has been made to 

dUU d Ucldli cllliy ikj a uiialii 

which has reached the max- 
imum allowable number of 
entries (65535). Current 
attempt is ignored, item is 
detail data set search item 
name and set is master data 
set name. 


Consult with data base 

aH m inictrjilT^r 

dU M II 1 II o LI d LUI ■ 


FULL MASTER FOR item/set 


Attempt has been made to 
add a detail data entry with 
a search item value that does 
not match any existing search 

ILclll VdlUc n) Lllc UUIIcbpoilU 

ing automatic master data 
set {set), and a new master 
entry cannot be created 
because the automatic master 
data set is full, item is the 
detail data set search item 
name. 


Consult with the data base 
administrator. 


ILLEGAL ACCESS 


You do not have write access 
to the data base because your 
access mode does not allow it. 


See Section 1 for a description 
of access modes and capabili- 
ties associated with each. 
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Table 6-15. UPDATE Command Messages (Continued) 



MESSAGE 


MEANING 


ACTION 


ILLEGAL DATA ITEM NAME 
name 


Data item called name 
either does not appear in 
thp data ha*ip hpina arppiied 
or is not a member of the 
specified data set. 


Re-enter command with 
correct data item name. Use 
FORM pommand to dptprminp 
valid data item name. 


ILLEGAL DATA SET NAME 

name 


Data set called name is not 
a member of the data base 
currently being accessed. 


Check the data set name by 
using the FORM command 
and change the data base 
name if nprsssarv 


ILLEGAL ITEM LENGTH - 
ITEM IGNORED 


Data item being referenced 
is not the proper size and 
type to be processed by 
QUERY, if the data item is 
a search or sort item, the 
command terminates. 


See Section 1 for a discussion 
of data types supported by 
QUERY. 


ILLEGAL NAME 


UPDATE procedure name 
exceeds eight characters, 
contains an illegal character, 
or consists of a reserved 
word. 


Use DISPLAY LIST to list 
the procedures in the Proc- 
file. 


ILLEGAL UPDATE TYPE 


Character string following 
UPDATE is not ADD, 
REPLACE, or DELETE. 


Re-enter the command. 


INPUT ERROR - REENTER 


Illegal character has been 

inmit nnH linp iq innrtrpH 


Re-enter the command or 
1 ine 


INPUT TOO LONG - 
TRUNCATED 


Data item value entered is 
longer than the maximum 
defined length for the data 

i^ofn \/qiiio ic ^ri mf^^i'ori 
ILCIII. Value lo LIUMOaLCU UN 

the right and processing 
continues. 


None. 


INVALID NUMERIC DIGIT 


Value entered for a data item 
defined as type Z or P con- 
tains an invalid or non- 
numeric digit. 


Check value and re-enter 
command. 


MISSING CHAIN HEAD FOR 
item/set 


Attempt made to add an 
entry to a detail data set 
linked to the specified 
master data set without a 

I'Ui 1 cdfjul lu 1 1 ly CI 1 LI y iii liic 
master data set for the 
search item value, item is 
the detail data set search 
item and set is the master 
data set name. 


Add an entry with the same 
search item value to the 
master data set and then 
re-enter this command. 
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Table 6-15. UPDATE Command Messages (Continued) 



MESSAGE 


MEANING 


ACTION 


NON-NUMERIC IN REAL 
VALUE 


Value entered for a data item 
defined as type real contains 
an illegal character, or the 
value is larger than the maxi- 
mum allowable value for the 
data type. 


See Section 1 for a discussion 
of data types and ranges. 
Re-enter command with 
correct value. 


NOT AN UPDATE PROCEDURE 


Referenced procedure is not 
a proper UPDATE procedure. 


Use DISPLAY and DISPLAY 
LIST to determine correct 
procedure name. Re-enter 
command. 


NUMERIC VALUE ERROR — 
ITEM IGNORED 


Value entered contains an 
illegal character or too 
many characters. 


Check value and re-enter 
command. 


REAL VALUE ERROR - 
ITEM IGNORED 


Real value contains an 
illegal character or is not in 
the proper range for the 
data item defined. 


See Section 1 for a discus- 
sion of data types and ranges. 
Re-enter command with 
correct value. 


RECORD HAS NOT YET BEEN 
FOUND 


UPDATE REPLACE or 
UPDATE DELETE com- 
mand has been entered prior 
to selecting entries with a 

nllMLy UUII It 1 Idi lU . 


Use the FIND command and 
then re-enter the UPDATE 
command. 


SCRATCH FILE READ ERROR 
code 


Physical error has occurred 
while MPE file system read- 
ing from a OUERY scratch 
file. File is not accessible to 
user, code is an MPE file 
system code. 


See FILE OPEN ERROR in 
table 6-2. Try command again 
or consult with data base 
administrator or system 
manager. 


UPDATE TO MORE THAN 
ONE SET 


(delete ] 

UPDATE { \ 

(replace) 

command used on entries 
selected with FIND CHAIN 
command. 


You can only use the FIND 
command to select entries to 
be replaced or deleted. 


WHAT IS THE VALUE OF name 


Prompt for a data Item value. 
name is the name of the data 
item in the UPDATE com- 
mand that contains a null 
data item value. 


Supply the requested data 
item value. 
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Table 6-16. XEQ Command Messages 



MESSAGE 



MEANING 



ACTION 



END OF XEQ FILE 



EXPECTED A ". 



FILE NOT TYPE ASCII 



ILLEGAL NAME 



PARAMETER ERROR 



End-of-file encountered in 
XEQ file. 

Comma must follow the file- 
name when using the optional 
NODATA parameter. 

The XEQ file is not an ASCI I 
file. 



XEQ filename is not valid 
(begins with a non-alphabetic 
character.) 

Optional parameter 
NODATA is not 
recognizable. 



None. 



Re-enter command with 
comma. 



Check the file and re-enter 
the command with the 
correct file type. 

Check the name and the MPE 
Commands Reference Manual 
for valid file names. 

Re-enter command with para- 
meter spelled properly. 
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QUERY/3000 COMMAND 

SUMMARY 



ADD 
ALTER 



CREATE 



DATA-BASE= 



DATA-SETS= 



DEFINE 



DELETE 
DESTROY 



see UPDATE ADD 



Inserts, replaces, and deletes lines of a procedure stored in the Proc-file. 



I ALTER j procedure 



name 



/l,m 

!R,m[,n] 
ID,m[,n] 

/E 



m and n are line numbers; m <n 



Creates new FIND, REPORT, or UPDATE procedures. 

(create 



SPACE 



or 



( CREATE ] ( filename 

\ \ procedure name, \ 

[ C j ( command 



Indicates which data base is to be accessed. 
DATA-BASE= 



B= 



data base name 



Indicates which data sets to access. 

( DATA-SETS= 1 
{ \ [data set list] 



Lists the status of all Environment commands and enables changes. 

I DEFINE 1 
[DEF ) 



see UPDATE DELETE 



Deletes a procedure from the Proc-file. 

destroy] 

1 procedure name 
DE J 



A-1 



Lists a procedure or lists the names of all the procedures stored in the 
Proc-file. 



DISPLAY 1 
D 



LIST 



or 



f display! 

I ^ ) procedure name 



\m[,n] 
, filename 



Terminates QUERY execution. 

ID 



Locates data entries in the data base according to user specifications. 

( find) 



F j 



or 



or 



procedure name [,character] 



FIND I 
F I 



relation 



and! 

OR J 



relation. 



[END] 



find! 

F j 



CHAIN item identifier < 



IS \ 

IE 
EQ 



"value" 



I and! 

(OR j- 



[END] 



or 



FIND I 



F 



ALL [data set name.] data item name 



Lists information about the structure of the data base currently being 
accessed. 



data set name 
data item name 
SETS 
ITEMS 
L PATHS 



form! 

FO j 



Prints information about the QUERY command set, 
command name 



help! 



FUNCTION 
FU 



FORMAT 
FO 



PARAMETERS 
PA 



LIST 



MODE= 



OUTPUT= 



PASSWORD= 



PROC-FILE= 



RENAME 



REPLACE 
REPORT 



Prints complete or partial entries from a single data set with automatic 
formatting and headings. 



LIST ] j data set name 
L j ( dato item list 



[FOR relation 



and] 

OR j 



relation. 



] [END] 



Changes the mode of access. 

(mode=| 



mode number 



Specifies the QUERY list output device for some of the QUERY 
commands. 

|OUTPUT=l I TERM I 
|o= j iLP j 



Changes your password. 
PASSWORD=l 



I PASSWORD=J 
|PA= I 



password 



Specifies which file QUERY is to use to store and execute procedures. 
( PROC-FILE= 



filename [,n] 



Changes a procedure name 
( RENAME ) 



I REN ) 



old procedure name, new procedure name 



see UPDATE REPLACE. 



Lists the item values located by a FIND command. 

(report) 



I 



[output control statements] ALL [.character] 



or 



[REPORT] 



I 



report statements END 



or 



I report! 

U I 



[output control statements] procedure name [,character] 



A-3 



REPORT 
Statements: 

Header 



Detail 



Edit 



Sort 



Group 



Total 



Register 



Output 
Control 



UPDATE 



H header number, print element, print position [,SPACE A [number] ] 
[,SPACE B [number] ] 

D [detail number] ,print element, print position [, SPACE A [ number] ] 



[,SPACE B [number] ] 



,SKIP 



B 



,E 



number 



'El number, "edit mask' 



S [level] ,data item name 



' |ASC 
'joES 



G level, print element, print position [, SPACE A [number] ] 



[,SPACE B [number] ] 



.SKIP 



.E 



number 



T level, print element, print position [, SPACE A [number] ] 



[.SPACE B [number] ] 



,SKIP 



,E 



number 



ADD 

AVERAGE 
COUNT j 



IL[OAD] \ 
A[DD] 
S[UBTRACT] > , data element 
M[ULT1PLY] I 
D[IVIDE] / 

LINES =integer 

NOPAGE 
[OUT=] LP 
PAUSE 



Executes an UPDATE command procedure. 

[update] 



procedure name [, character] 



A-4 



Adds data entries to the data base. 



' UPDATE ADD/ 

U ADD, 

ADD [,] 
V AD [,] 



data set name 



Deletes data entries from the data base. 

UPDATE DELETE 
U DELETE 
DELETE 
DEL 



Modifies the values of data items. 

' UPDATE replace'! 
U REPLACE I ,data item name="value"; 
REPLACE I ["^^ta item name="value"; ] END 

^ REPL / 

Displays the current version of QUERY and IMAGE procedures and 
program files. 



I VERSION I 



Executes QUERY commands from a file instead of the standard input 
device. 



XEQ 
X 



filename [,NODATA] 



ASCII CHARACTER SET 



GRAPHIC COMMENTS GRAPHIC COMMENTS 



Null 


* 


Asterisk 


Sf.avt. of hpafiino" 

VJ VCLi. l> \J±. l.X\ifA\AlHC^ 


+ 


Plus 


Start of tpxt 




Comma 


End of text 




Hyphen (minus) 


Rnd of transmission 




Period (Decimal) 


FlnniiiTv 


/ 


Slant 


Acknowledge 


0 


Zero 


Bell 


1 


One 


Backspace 


2 


Two 


Horizontal tabulation 


3 


Three 


Tjine fppd 


4 


Four 


Vertical tabulation 


5 


Five 


Form fppH 

J. \JLLH 


6 


Six 


Clarriacfp rptiirn 


7 




Shift nut 

k-'XxxXL' \J Li. Li 


g 


Eight 


Shift in 

kJlXxXU 111 


9 


Nine 


F)flta linlc pcipanp 




Colon 


T^pviop pontrol 1 




Sptyi ipol on 

kJClllX^v/l^ll 


Dpvifp control 2 


< 


TjPss than 

XJ\^00 vXXCXXX 


T^pvipp pontrol i\ 

^v^xxuxv^x u 




Eniials 


F)pvipp pontrnl A 

JL/^VXV-C X^WllUAWl 


> 


rrVpatpr than 

X v!^ CX L X lilldll 


Mpcffltivp aplcnowlpHo'p 

CgCLl/l V C ClV^XVllV^ VV ICUKt^ 
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JJ 


T Tnnoivr'Qco Ti 


End of medium 


c 


UnDercase C 


Substitute 


D 


Uppercase D 


Escape 


E 


Uppercase E 


File separator 


F 


Uppercase F 


Group separator 


G 


Uppercase G 


Record separator 


H 


Uppercase H 


Unit separator 


I 


Uppercase I 


Space 


J 


Uppercase J 


Exclamation point 


K 


Uppercase K 


Quotation mark 


L 


Uppercase L 


Number sign 


M 


Uppercase M 


Dollar sign 


N 


Uppercase N 


Percent sign 


O 


Uppercase O 


Ampersand 


P 


Uppercase P 


Apostrophe 


Q 


Uppercase Q 


Opening parenthesis 


R 


Uppercase R 


Closing parenthesis 


S 


Uppercase S 
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GRAPHIC 



COMMENTS 



GRAPHIC 



COMMENTS 



T 


Uppercase T 


j 


Lowercase j 


U 


Uppercase U 


k 


Lowercase k 


V 


Uppercase V 


1 


Lowercase 1 


w 


Uppercase W 


m 


Lowercase m 


X 


Uppercase X 


n 


Lowercase n 


Y 


Uppercase Y 


o 


Lowercase o 


Z 


Uppercase Z 


p 


Lowercase p 


[ 


Opening bracket 


q 


Lowercase q 


\ 


Reverse slant 


r 


Lowercase r 


] 


Closing bracket 


s 


Lowercase s 


A 


Circumflex 


t 


Lowercase t 




Underscore 


u 


Lowercase u 


\ 


Grave accent 


V 


Lowercase v 


a 


Lowercase a 


w 


Lowercase w 


b 


Lowercase b 


X 


Lowercase x 


c 


Lowercase c 


y 


Lowercase y 


d 


Lowercase d 


z 


Lowercase z 


e 


Lowercase e 


{ 


Opening (left) brace 


f 


Lowercase f 


1 


Vertical line 


g 


Lowercase g 


} 


Closing (right) brace 


h 


Lowercase h 




Tilde 


i 


Lowercase i 




Delete 
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EXCEPTIONAL ERROR 
CONDITIONS 



APPENDIX 



The following error messages are printed only after an exceptional error condition occurs 
due to a hardware or software failure. If these conditions persist, they may require the aid of 
HP support personnel. 



BAD DATA BASE NUMBER 

BAD DATA SET OR DATA ITEM REFERENCE 

BAD ITEM REFERENCE OR BAD LIST (SUB-SYSTEM ERROR) 

BAD MODE 

BEGINNING OF CHAIN 
BEGINNING-OF-FILE 

DATA BASE LOCKED BY ANOTHER PROCESS 
DATA BASE NOT ENABLED 
DATA ITEM LIST TOO LONG 

DBML ERROR P1,P2,P3 (P1,P2,P3 are status returns from an IMAGE/3000 intrinsic.) 

DIRECTED BEGINNING-OF-FILE 

DIRECTED END-OF-FILE 

DUPLICATE SEARCH ITEM VALUE 

END OF CHAIN 

END-OF-FILE 

FCLOSE FAILURE 

FOPEN FAILURE 

FREADDIR FAILURE 

FWRITEDIR FAILURE 

FWRITELABEL FAILURE 

FREADLABEL FAILURE 

FLOCK FAILURE 
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ACCESSING A REMOTE DATA BASE 



APPENDIX 



If you want to use QUERY to access a data base that resides on a remote HP 3000, there 
are three methods available. Method 1 is the most efficient since it minimizes communica- 
tions line traffic. 

METHOD 1: QUERY ON REMOTE SYSTEM 

You can log on to your local computer, establish a communications link, initiate a remote 
session, and run QUERY on the remote system. This method is illustrated in figure D-1. 
A user whose user name is USERL and whose account is ACCTL logs on to the local system. 
He then establishes a communications link with the remote system referenced as dsdevice 
SYSR. A REMOTE HELLO command establishes a session on the remote system with user 
identification MEMBER.PAYROLL. The user runs QUERY on the remote system accessing 
a data base named DBR. 



LOCAL TERMINAL 



HELLO USERL.ACCTL 
DSLINE SYSR 

REMOTE HELLO MEMBER.PAYROLL 
REMOTE RUN QUERY.PUB.SYS 

>DATA-BASE=DBR 



:REMOTE BYE 
:DSLINE SYSR;CLOSE 



LOCAL? HP3000 



REMOTEfHP3000 



I 



SYSR 

QUERY program 
Data Base DBR 



Figure D-1. Using Method 1 



For complete instructions on operating remote sessions, refer to the DS/3000 Reference 
Manual. 



METHOD 2: QUERY ON LOCAL SYSTEM 

The second method is similar to Method 1 except QUERY is run on the local system. 
First a :FILE command is used to specify the location of the remote data base. After 
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initiating execution of QUERY, you specify the data base name with the DEFINE or 
DATA BASE= command. The name of the data base must be the same as the name speci- 
fied as the formal file designator in the :FILE command. 

Figure D-2 illustrates Method 2. After USERL establishes a communications link and 
remote session on the remote system, he enters a file equation to specify that the data 
base DBR resides on a remote system with dsdevice name SYSR. The device type may be 
omitted if the default device type is acceptable. The user then runs QUERY on the local 
system and specifies the data base name DBR with the DATA-BASE- command. Note 
that the data base name is the formal file designator in the :FILE command 



LOCAL TERMINAL 



HELLO USERL.ACCTL 
DSLINE SYSR 

REMOTE HELLO MEMBER.PAYROLL 
FILE DBR;DEV=SYSR# 
RUN QUERY.PUB.SYS 

>DATA-BASE=DBR 



;REMOTE BYE 
:DSLINE SYSR;CLOSE 



i 



LOCAL? HP3000 



QUERY program 



REMOTE? HP3000 



SYSR 



Data Base DBR 



Figure D-2. Using Method 2 



METHOD 3: USING A DATA-BASE-ACCESS FILE 

The third method uses a data-base-access file to define the data base which is to be used. 
You must first log on to the local system and initiate QUERY execution. When specifying 
the data base name with the DEFINE or DATA BASE= command, you enter the name of 
a data-base-access file rather than a data base name. When IMAGE opens the data base, it 
recognizes the data-base-access file and programmatically establishes a communication link 
and remote session. If you use this method, QUERY automatically issues a REMOTE BYE 
and closes the DSLINE when you enter the QUERY EXIT command. 

Data-base-access files are usually created by the data base administrator or manner. De- 
tailed instructions for creating a data-base-access file are provided in the IMAGE Reference 
Manual, Section VIII. 

Figure D-3 illustrates Method 3. The user logs on to the system and runs QUERY. He 
specifies a data-base-access file name with the DATA-BASE= command. The data-base- 
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access file provides the necessary information to enable QUERY to establish a communi- 
cations link and remote session to access the data base DBR that resides on the remote 
system. The file contains the following records: 

Record 1 FILE DBR,DEV=SYSR#DISCA 
Record 2 DSLINE SYSR 

Record 3 USERL.ACCTL=HELLO MEMBER.PAYROLL 



LOCAL TERMINAL 



:HELLO USERL.ACCTL 
:RUN QUERY.PUB.SYS 

> DATA-BASE=DBAF I L 



:BYE 



i 



LOCAL? HP3000 



QUERY program 

Data-base-access 
file named DBAFIL 



I 



REMOTE f HP3000 

SYSR 



Data Base DBR 
resides on DISCA 



Figure D-3. Using Method 3 



Record 1 of the data-base-access file specifies the remote system on which the data base 
resides and the device class of the disc (DISCA) on which it resides. Record 2 specifies 
the Distributed Systems (DS) line and Record 3 indicates the remote username and account 
name which is to be used to establish a remote session for USERL.ACCTL. 
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INDEX 



A 

access modes, 1-9, 2-8, 2-11 
ADD command, see UPDATE ADD 
ADD option, 4-32, 4-36 
alphanumeric edit mask, 4-20 
ALTER command, 5-10 
ALTER command messages, 6-3 
ampersand (&) continuation character, 1-9, 2-4, 
5-3 

AND connector, 3-4 

ASC option, 4-25 

ASCII characters, 1-12, B-1 

ASCII files, 1-12, 5-2, 5-7 

ASSIGN command, 2-5a 

automatic data set list additions, 2-13 

automatic master data sets, 1-6 

AVERAGE option, 4-32 

B 

batch, 1-1 

break key, 2-3, 2-19 
:BYE command, 2-4 

C 

card reader, 2-4 
chains, 3-12 

character literal, 1-4 % 
character set, QUERY, 1-13 
commands, 1-1, 1-8, 1-9 

as procedures, 5-1 

summary, A-1 
compound data items, 1-6 
continuation character (&), 1-9, 2-4, 5-3 
control break, 4-27, 4-30, 4-33 
control H, 2-1 
control X, 2-1 
control Y, 2-3, 3-16, 5-10 
correcting REPORT statements, 4-44 
COUNT option, 4-32 
CREATE command, 5-2 

SPACE, 5-6 
CREATE command messages, 6-4 

D 

data base access, 1-1 
data-base-access file, 2-8,D-l 
data base administrator, 1-2 
DATA-BASE= command, 2-1, 2-4, 2-8 
DATA-BASE= command messages, 6-5 



data base designer, 1-2, 1-4, 1-6 
data base structure, 1-2, 1-7 
data entry, 1-3 
data item, 1-2 

fully-qualified names, 1-3 
data set, 1-2 
data set list, 2-2, 2-12 
data set selection rules, 2-12, 4-6 
DATA-SETS= command, 2-12 
DATA-SETS= command messages, 6-7 
data types, 1-4, 1-5 

and registers, 4-38 
data values, 1-4 
DATE option, 4-16 
DEFINE command, 2-1, 2-6 
DELETE command, see UPDATE DELETE 

command 
delete statement (/D), 5-13 
DES option, 4-25 
designing a report, 4-14 
DESTROY command, 5-15 
DESTROY command messages, 6-7 
detail data set, 1-6, 3-11, 3-16 
detail search item, 3-11 
detail statement, 4-18 
device class (type), 1-12, 2-18 
DISPLAY command, 5-7 

DISPLAY LIST, 5-9 
DISPLAY command messages, 6-7 
Distributed systems (DS/3000), 2-8,D-l 
DIVIDE option, 4-36 

E 

edit mask, 4-20 

edit statement, 4-20 

EDIT/3000, 5-5 

end statement (/E), 5-14 

environment, access mode, 1-11 

environment commands, 2-2 

:EOJ command, 2-22 

error messages, 6-1 

exceptional error conditions, C-1 

EXIT command, 2-22 

extended precision, 1-5 

F 

field widths, LIST output, 4-4 
:FILE command, 1-12, 2-18, 4-10 
file, displaying to a, 5-7 
file input, CREATE, 5-3 
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file, QUERY commands from a, 5-1 
FIND command, 2-12, 3-1, 3-3 

FIND ALL, 3-9 

FIND CHAIN, 3-11 

FIND procedure, 3-10 

relational operators, 3-4 
FIND command messages, 6-8 
foldout, 4-45 

FORM command, 1-3, 2-23 
FORM command messages, 6-11 
format, LIST output, 4-4 
FORMAT option, 2-28 
fully-qualified names, 1-3 
FUNCTION option, 2-28 

G 

general messages, 6-1 
group statement, 4-29 

H 

H'^, 2-1 

header statement, 4-16 
: HELLO command, 2-1 
HELP command, 2-3, 2-28 

I 

IMAGE/3000, 1-1, 1-6, 6-1 
initializing registers, 4-37 
insert statement (/I), 5-11 
interactive mode, 2-1 
ITEMS option, 2-23 

J 

job, 1-1, 2-1, 2-4, 3-21 
: JOB command, 2-4 

K 

key item, 1-6, 2-24 
key words, 1-1 

L 

line printer, 2-4 
LINES= statement, 4-42 
LIST command, 2-12, 4-1, 4-2 
LIST command messages, 6-11 
literal, 1-4 
LOAD option, 4-36 
locking data base, 1-10 
LOCKOPTION, 2-5a, 2-29a 
logging, 1-12 

logical connectors, 3-4, 4-4 
log-on procedure, 2-1 
LP device class, 1-12 
LP option, 2-18 



M 

major to minor sort fields, 4-27 
manual master data set, 1-6, 3-16 
master data sets, 3-11, 3-18 
master search item, 3-11 
missing chain head, 3-16 
MODE= command, 2-11 
modes of access, 1-9 
MPE, 2-1 

files, 1-12 
multiple search values, 3-5 
MULTIPLY option, 4-36 

N 

negative number representation, 4-10 
NODATA option, 5-17 
NOPAGE statement, 4-42 
null values, 3-6, 3-15, 3-21 
numeric edit masks, 4-21 

characters, 4-22 

combinations, 4-23 
numeric literal, 1-4, 4-39 

O 

OR connector, 3-4 

OUT statement, 4-42 

OUTPUT= command, 2-18, 2-24, 2-29 

OUTPUT= command messages, 6-13 

output control statements, 4-42 

output file, 2-2 

P 

packed decimal number, 1-4,1-5 
PAGENO option, 4-16 
PARAMETERS option, 2-28 
passwords, 1-2, 2-8 
PASSWORD= command, 2-10 
PATHS option, 2-23 
PAUSE statement, 4-42 
procedure, 1-1, 2-16, 5-1 
Proc-file, 1-1, 2-2, 2-16, 5-1 
PROC-FILE= command, 2-4, 2-16, 5-1 
PROC-FILE= command messages, 6-14 

Q 

QSLIST fUe, 1-12, 2-18, 2-24, 2-29, 2-30, 5-9 
QUERY registers, using, 4-37 

R 

real number values, 1-5, 3-15a, 4-38 

report output, 4-21 
register statement, 4-36 

initializing, 4-37 
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relational operators, 3-4, 4-3 

remote data base access, 2-8,D-l 

RENAME command, 5-16 

RENAME command messages, 6-15 

REPLACE command, see UPDATE REPLACE 

replace statement (/R), 5-12 

REPORT command, 4-1, 4-13 

REPORT ALL, 4-10 

REPORT procedure, 4-44 
REPORT command messages, 6-15 
: RESUME command, 2-3 
:RUN command, 2-1 

S 

sample data base, 1-6 

search item, 1-6, 2-24, 3-11 

security, 1-1, 3-18 

serial searching, 3-2 

session, 1-1, 2-1, 3-21 

SETS option, 2-23 

SHOW command, 2-29a 

SKIP option, 4-18, 4-32, 4-45, 4-45b 

slash character, 3-16, 5-3 

sort item, 1-6, 2-24 

sort statement, 4-25 

SPACE option, 4-16, 4-18, 4-32, 4-45, 4-45b 

special characters, 1-12 

standard list device, 2-29, 2-30 

statement parameters summary, 4-45 

$STDLIST, 1-12, 2-4, 2-18, 4-39, 4-42, 6-1 

STORE data base, 1-6 

structure of data base, 1-2, 1-7 

sub-items, 1-6 

SUBTRACT option, 4-36 

summary of QUERY commands, A-1 

SYSDUMP, 1-10 



T 

TAPE option, 2-19 
TERM option, 2-18 
terminal input, CREATE, 5-3 
terminating commands, 3-16, 5-3 
TIME option, 4-16 
total statement, 4-32 

U 

U type values, 3-4, 3-15 
unlocking data base, 1-10 
UPDATE ADD command, 3-1, 3-14 
UPDATE command messages, 6-21 
UPDATE DELETE command, 3-1, 3-18 
UPDATE procedure, 3-24 
UPDATE REPLACE command, 3-1, 3-20 
using serial read, 3-2 

V 

VERSION command, 2-30 
X 

X^, 2-1 

X type values, 3-4, 3-15 
XEQ command, 5-1, 5-17 
XEQ command messE^es, 6-25 

Y 

Y^, 2-3, 3-16, 5-10 
Z 

zoned decimal number, 1-5 
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Revontulentie. 7 
SF-02100 Espoo 10 
Tel: (90) 455 0211 
Telex: 121563 hewpa si 

FRANCE 

Hewlett-Packard France 
Zone d'activiles de 

Courtaboeul 
Avenue des Tropk^ues 
Boile Poslale 6 
91401 Oraay-CMex 
Tel: (1)907 78 25 
TWX:600048F 
Hewletl-Packard France 
Chemin des Mouies 
BP. 162 
69130 Ecully 
Tel: (76) 33 81 25 
TWX:310617F 
Hewlelt-Packard Franca 
20, Chemin de la C6plire 
31061 Toulousa 
La Mirall^Mex 
Tel: (61) 40 11 12 



Hewlell-Packard France 
le ligoures 

Place Romte de Vieneuve 
13100 Alx<«i-Provanca 
Tel: (421 59 41 02 
TWX: 410770f 
Hewlell-Packard France 
2. Alee de la Bouigonelta 
35100 Rannaa 
Tel: (99) 51 42 44 
TIKX: 740912F 
Hewletl-Packard France 
18. nje du Canal de la Mama 
67300 Sehlltighalm 
Tel: (86) 83 08 10 
TWX: 890141F 
Hewlett-Packard Franca 
hmieuble pidcenKe 
rue van Gogh 

59650 vnianauva D'Ascq 

Tel: (201 91 41 25 

TWX: 160124F 

Hewlett-Packard France 

BitimenI Amp^e 

Rue de la Commune de Paris 

B P 300 

93153 La Blanc Maanll 

CMex 
Tel: (01) 931 88 50 
Telex: 211032F 
Hewlell-Packard France 
Av. du Pdl. Kennedy 
33700 Marlgnac 
Tel: (56) 97 01 81 
Hewlett-Packard France 
Immeuble Lorrarie 
Boulevard de France 
91035 Evry-C6dex 
Tel: 077 96 60 
Telex: 692315f 
Hewlell-Packard France 
23 Rue lolhaire 
57000 Mati 
Tel: (87) 65 53 SO 
GERMAN FEDERAL 
REPUBLIC 
Hewlett-Packard GmbH 
Venriabszenlrale Frankfurt 
BemerSlrasse 117 
Postfach 560 140 
0-6000 Frankfurt 56 
Tel: (0601 1)50041 
Telex: 04 13249 hpltm d 
Hewlett-Packard GmbH 
Technisches Bliro Boblkigen 
Herrenberger SIrasse 1 10 
0-7030 BUbllngan, 
WUrttemberg 
Tel: (07031) 667-1 
Tetex: 07265739 bbn 
Hewletl-Packard GmbH 
Technisches BUro DtJsseklorl 
Emanuei-Leutze-Slr. 1 

(Seeslern) 
0-4000 DUaaaldarf 
Tel: (0211) 5971-1 
Telex: 086/86 533 hpdd d 
Hewletl-Packard GmbH 
Technisches BUro Hamburg 
Kapsladtring 5 
D-2000 Hamburg 60 
Td: (040) 63804-1 
Telex:2 1 63 032hphhd 
Hewlett-Packard GmbH 
Technisches BUro Hannover 
Am Grossmarkt 6 
D-3000Hannovor91 
Tel: (0511) 46 60 01 
Telex: 092 3259 
Hewletl-Packard GmbH 
Technisches ewo NUmberg 
Neumeyerslrasse 90 
D 8500 Nilrnbarg 
Tel: (0911) 52 20 83 
Telex: 0623 860 

Hewlell-Packard GmbH 
Technisches BUo Mllnchen 
Eschenslrasse 5 
D-8021 Taufklrchan 
Tel: (089) 6117-1 
Telex: 0524985 
Hewlett-Packard GmbH 
Technisches BUro Berlin 
Kailhstrasse 2-4 
D-1000BarHn30 
Tel: (030) 24 90 66 
Telex: 016 3405 hpUn d 

GREECE 

Koslas Karayannis 
8 Omirou Street 
Athana 133 

Tel: 32 30 303/32/37 731 
Telex: 21 59 62RKARGR 



GUAM 

Guam Medical Supply, inc 
Suile C, Axport Plaza 
P.O. Box 8947 
Tamunlng 96911 
Tel: 646-4513 

GUATEMALA 

FESA 

Avenkla Retorma 3-48 
Zona 9 

Guatamala City 

Tel: 316627. 314786, 

66471-5. ext. 9 
Telex: 4192 TelelroGu 

HONG KONG 

Hewlett-Packard Hong Kong 
IM. 

nihFkxir. Four Seas BMg. 
212 Nathan Rd. 
Kowloon 

Tel: 3-697446 (5 InesI 
Telex: 36678 HX 
MedKal/Analytkal Only 
Schmidt > Co. (Hong Kong) 

ltd. 

Wmg On Centre. 28th Fkwi 

Connaughl Road. C. 

Hong Kong 

Tel: 5-455644 

Telex: 74766 SCHMX HX 

INDIA 

Skje Star ltd. 

Sahas 

414/2 VirSavarkarMarg 
Prabhadevi 
Bombay 400 025 
lel: 45 78 87 
Telex: 011-4093 
Bke Star ltd. 
Band Box House 
Prat)hadevi 
Bombay 400 025 
Tel: 45 73 01 
Telex: 011-3751 
Blue Star LU. 
Bhavdeep 
Stadium Road 



Tel: 43922 
Telex: 012-234 
Blue Star ltd. 
7 Hare Street 
Calcutta 700 001 
Tel: 23-0131 
Telex: 021-7655 
Bkje Star ltd. 
Bhandari House 
91 Nehru Place 
NawDalM 110 024 
Tel: 682547 
Telex: 031-2463 
Bkie Slar Ltd. 
T.C. 7/603 'Poomima' 
Marulhankuzhi 
Trivandrum 695 013 
Tel: 65799 
Teiex: 0884-259 
Bkje Star Ltd. 
1 1 Magaralh Road 
Bangalora 560 025 
Tel: 55668 
Tekix: 0B45-4X 
Bkie Star IM. 
Meeakshi Mandiram 
XXXXV/1379-2 Mahalma 

Gandhi Rd. 
Cochin 682 016 
Tel: 32069 
Telex: 065-514 
Bkie Star ltd. 

1-1-117/1 Sarojini Devi Road 
Sacundarabad 500 033 

Tel: 70126 
TekiX: 0155-459 
Bkie Star ltd. 

133 Kodambakkam High Road 
Madraa 600 034 

Tel: 82057 
Telex: 041-379 

k:elano 

Medk^ Only 

Ekiing Trading Company bic. 
Halnarnvoli - TryggvagOKi 
P.O. Box 895 
IS-Rayk|a>ik 

Tel: 1 56 20/1 63 03 

INDONESIA 

BERCA hdonesia P.T. 
P.O. Box 496/Jkt. 
jm. Abdli Muis 62 
JakarU 

Tel: 349255. 349886 
Tek»: 46748 BERSL lA 



BERCA Indonesia P.T. 
P.O. Box 174/Sby. 
23 jm. Jknerto 
Surabaya 
Tel: 42027 

IRELAND 

Hewlelt-Packard IM. 
Kestrel House 
Clanvriiam Place 
Lower MounI Street 
DubHn 2. Eire 
Hewlelt-Packard ltd. 
2C Avongberg kid. Est. 
long MUe Road 
Dublin 12 
Tel: 514322/514224 
Telex: 30439 
Medical Omy 

Cardiac ServKes (keland) LM. 

Kknore Road 

Artane 

Dublin 5. Eire 
Tel: (01) 315820 
MedKalOnly 
Cardiac Sarvices Co. 
95A Finaghy Rd. South 
BalfaatBTIO oev 
GB-Norlhern Ireland 
Tel: (0232) 629566 
Telax: 747626 
ISRAEL 

Eleclroncs Engineenng DIv. 

of Motorola Israel lid. 
16. Kremenetski Street 
P.O. Box 25016 
Tal-A<iv 
Tel: 36973 
Telex: 33569. 34164 
ITALY 

Hewlelt-Packard Italana S.p.A. 
Via G. Di VMoik). 9 
20063 Carnuaco Sul 

Navigllo (HI) 
Tel: (2) 903691 
Telex: 334632 HEWPACKIT 
Hewletl-Packard ttaiana Sp.A. 
Via Tirazza, 14 
35100 Padova 
Tel: (49) 664888 
Telex: 430315 HEWPACKI 
Hewletl-Packard ttaiana S.p.A. 
Via G. Annelini 10 
1-00143 Roma 
Tel: (06) 54 69 61 
Tekix: 610514 

Hewlelt-Packard Itakana S.p-A. 
Corso Giovanni lanza 94 
1-10133 Torino 
Tel: (011)659308 
Telex: 221079 

Hewletl-Packard Itakana S.p.A. 
Via Principe Nicola 43 G/C 
1-95126 Catania 
Tel: (095) 37 05 04 
Telex: 970291 

Hewletl-Packard naiana S.p.A. 
Via Nuova san Rocco A 

Capadknonle. 62A 
80131 Napoll 
Tel: (061) 710698 
Hewlelt-Packard ttaiana S.p.A. 
Via Manm Lulher Kkig. 36/1 1 1 

1- 40132 Bologna 
Tel: (051) 402394 
Tekix: 511630 

JAPAN 

Yokogawa-Hewlett-Packard 
Ltd. 

29-21. Takaido-Hlgashi 

3-chome 
Suginami-ku. Tokyo 168 
Tel: 03-331-6111 
Telex: 232-2024 YHP-Tokyo 
Vokogawa Hewtetl-Packard 

Lid. 

Chuo BUg.. 4lh Floor 
4-20. Nishinakafima 5-chome 
Yodogawa-ku. Osaka-shi 
Osaka, 532 
Tel: 06-304-6021 
Telex: 523-3624 
Ydkogawa-Hewlell-Packard 
lid. 

Sunilomo Seimei Nagaya BMg. 
1 1-2 Shimosasajima-cho. 
Nakamura-ku, Nagoya, 450 
Tel: 052 571-5171 
Yokogawa-Hewlell-Packard 
lid 

Tanigawa Bukling 

2- 24-1 Tsunjya-cho 
Kanagawa-ku 
VokohaiM, 221 

Tel: 045-312-1252 
Telex: 382-3204 YHP YOK 



Yokogawa-Hewlell-Packard 

ltd. 

MHO Mitsu BuUiig 

105, 1-chome, San-no-mani 

Mito, karagi 310 

Tel: 0292-25-7470 

Yokogawa-Hewlelt-Packard 

IKI. 
Hioue Bulking 

1348-3, Asahi-cho. 1-chome 
Ataugl, Kanagawa 243 
Tel: 0462-24-0452 
Yokogawa-Hewlelt-Packard 

IM. 

Kifnagaya Asahi 
Hachjjuni BuUing 
aihFkioi 
3-4. Tsukuba 

Kumagaya, Saitama 360 
Tel: 0465-24-6563 

JORDAN 

Mouasher Cousins Co. 
P.O. Box 1387 
Amman 

Tel: 24907/39907 
Telex: SABCO JO 1456 
KENYA 

AOCOM Ltd., kic. 
P.O. Box 30070 
Nairobi 

Tei: 331956 
Teiex 22639 
Medical Only 

kilernalional Aeradn (E.A.) ltd. 

P.O. Box 19012 

Nairobi Airport 

Nairobi 

Tel: 336055/56 

Tetex: 22201/22301 

Medical Only 

kilernalkmal Aeradk) (E.A.) ltd. 
P.O. 80x95221 



KOREA 

Samsung Electronics Co.. ltd. 
4759 Shingi-6-Dcng 
Yeong Oeiaig POU 
Saoul 

Tel: 833-4122, 4121 
Tekx: SAMSAN 27364 

KUWAIT 

Al-Khakliya Tradkig & 

Contracling 
P.O. Box 830-Salat 
Kuwait 

Tel: 42 4910/41 1726 
Telex: 2481 Areeg kt 

LUXEMBURG 

Hewlelt-Packard Banakjz 

S.A./N.V. 

Avenue du Col-Ven, 1 

(Groenkraaglaan) 

B-1170Bruaaala 

Tel: (02) 660 5050 
TekiX: 23 494 

MALAYSIA 

Hewlatt-Packaid Sales 
(Malaysia) Sdn. Bhd. 
Suite 2.21/2.22 
Bangunan Angkasa Raya 
Jalan Ampang 
Kuala Lumpur 
Tel: 483680. 485653 
Prole! Engkieenng 
P.O. Box 1917 
Lol 259. Satok Road 
Kuching. Sarawak 
Tel: 53544 
MEXICO 

Hewlell-Packard Mexicana. 

S.A. de C.V. 
Av. Peril^nco Sur No. 6501 
Tepepan. Xochimikw 
Maxico 23. O F. 
Tel: 905-678-4600 
Telex: 017-74-507 
Hewletl-Packard Mexk»na. 

S.A. de C.V. 
Rk> Volga »600 
Col . Del Vale 
Montarray, N.I. 
Tel: 78-32-10 

MOROCCO 

Oolieau 

81 rue KaralcN 

Casablanca 

Tel: 3041 82 
Tekix: 23051/22822 
Gerep 

2, rue d'Agadir 
Bolle Postal 156 
Caaablanca 

Tel: 272093/5 

Telex: 23 739 



MOZAMBmUE 

A.N. Goncalves. Lid. 
162, 1* Apt. 14 Av. 0. Ills 
Caixa Postal 107 
Maputo 

Tel: 27091, 27114 
Telex: 6-203 NEGON Ho 

NETHERLANDS 

Hewlett-Packard Banatjx N.V. 
Van Heuven Goadhartlaan 121 
P.O. Box 667 
iiBiKKAmatalvaafl 

Tel: (201 47 20 21 
Telex: 13 216 

NEW ZEALAND 

Hewlett-Packard (N.Z.) M. 
4-12Cnickshank Street 
KWrnie. Wemglon 3 
P.O. Box 9443 
Coutney Place 
WalMngton 
Tel: 677-199 

Hewlett-Packard (N.Z.) Lkl. 
P 0.80x26-189 
169 Hanukau Road 
Epsom. Auckland 
Tel: 667-159 
AnalytlcalAMIcal Only 
Northrop Inslnjmants A 

Systems IM., 
Sturdee House 
85-87 Ghuznee Streat 
P.O Box 2406 
Walllngton 
Tel: 850-091 
Telex: NZ 31291 
Northrup kistnments & 

Systems IM. 
Eden House, 44 Khyber Pass 

Rd. 

P 0 Box 9682. Nawmaikel 
Auckland 1 
Tel: 794-091 
Northrup kistruments & 

Systems Ltd. 
Terrace House. 4 Oxiord 

Terrace 
P.O. Box 6366 
Chrlatcliurch 
Tel: 64-165 
NIGERIA 
The Electronics 

tnstnjnentatkxis IM. 
N6B/770 0yoRoad 
Okiseun House 
P.M.B. 5402 



Tel: 461577 

Telex: 31231 TEL NG 

The Eleclronlcs 

kistrumentatktns lkl. 
144 Agege Motor Road. Hushin 
P.O. Box 481 
Hushin. Lagoa 
NORWAY 

Hewlell-Packard Norge US 
Oslendalen 16 
P.O. Box 34 
1345 Oataraaa 
Tel: (02) 1711 80 
Telex; 16621 hpnas n 
Hewlell-Packard Ncrge A/S 
Nygaardsgaten 114 
P.O. Box 4210 
5013 Nygaardsgaten. 
Bargan 

Tel: (051 21 97 33 
PANAMA 

Electr^nico Baboa. S.A. 
Aparatado 4929 
Panama 5 
Cale Samuel lewis 
Edifcn -Atta.' No. 2 
Cludad do Panama 

Tel: 64-2700 

TeK>: 3483103 Cunindu. 

Canal Zone 

PERU 

Compania EbKlro MMna S.A. 

los Flamencos 145 

San Iskiro Caslla 1030 

Uma 1 

Tel: 41-4325 

Telex: Pub. Boom 25424 



PAKISTAN 

Mushko t Company lkl. 
Oosman Chambers 
AbduWi Haroon Road 
KaracM-3 

Tel: 511027. 512927 
Telex: 2894 



□ 



2 1 SALES OFFICES 

Arranged alphabetically by country (cont.) 



Mushko 1 Conipany, Ltd. 
10. Buar Rd. 
Seclot G-e/4 



Tel: 28264 

PHILIPPINCS 

The Onine Advanced Systems 

Corporation 

Kco House 

AiiKxsolo cor. Herrera SIT. 
Legaspi Viage. MakaH 
P O Ba> 1510 
Metro Manna 

Tel: 85-35-81. 85-34-91. 
85-32.2 1 

Telex: 3274 ONUNE 

RHODESIA 

Field Technical Sales 
45 Kelvin noad North 
P.O. Box 3458 
Salisbury 

Td: 705231 15 Ines) 
Telex: RH 4122 

POLAND 

Biuro Inlonnaqi Technicznej 
Hewletl-Packard 
Ul Stawkl 2. 6P 
PLX'950 Warsiawa 
Tel: 39 59 62, 39 51 87 
Telex: 81 24 53 

PORTUQAI. 

Teteclra-Empress Ttoiica de 
Equpamentos Elficlricos 

S.a.t.l. 

Rua Rodrigo da Fonseca 103 

P.O. Box 2531 

P-Uabo« 1 

TH: 119)68 60 72 

Telex: 12598 

Medical Only 

Mundinler 

tntercambio Mundial de 

Com^rcio S.a.r.l. 
P.O. 60x2761 
Avenlda Antonio Augusto 
deAgiiar 138 



Tel: (19) 53 21 3177 
Telex: 16691 munter p 

PUERTO raco 

Nevltelt-Packard tnur- 

Americas 
F\ierto Rico Branch Office 
Calle272. 

»203 Urb. Country CU) 
Carolln 00630 
Tel: (809) 762-7255 
Telex: 345 0514 

OATAR 

Nasser Tradhg A Contracting 
P-0 Box 1563 
Doha 
Tel: 22170 
Telex: 4439 NASSER 
ROMANIA 
Hevilelt-Pacliard 
Reprezentanta 
Bd.n. Balcescu 16 
Bucuraati 

Tel: 15 80 23/13 88 85 
Telex: 10440 

SAUDI ARABIA 

Modem Electronic 
EslaHshmenI (Head Office) 
P.O. Box 1228, Baghdadiah 
Street 



Tel: 27 798 
Telex: 40035 
Cable: ELECTA JEDDAH 
Modem Electronic 

Establishment (Branch) 
P.O Box 2728 
Riyadh 

Tel: 62596/66232 
Telex: 202049 
Modem Electronic 

Eslabishmenl (Branch) 
P.O. Box 193 
AHChobar 
Tel: 44678^13 
Telex: 670136 
Cable: ELECTA AL-KHOBAR 

SINGAPORE 

Hewielt-Packard Singapore 

(Pte.) Ltd. 
6lh FkKx. kichcape House 
450-452 Alexandra Road 
P 0. Box 58 
Atexandra Post Otfice 
Singapore 9115 
Tel: 631788 
Telex: HPSGRS 21486 



SOUTH AFRICA 

Hevriett-Psdiard South AMca 

(Ply.), Lid. 
Private Bag Wendywood, 
Sandton, Transvaal, 2144 
Hewlett-Packard Centre 
Daphne Street, Wendywood, 
Sandton, 2144 
Tel: 802-5111/25 
Telex: 8-4782 

Hewtett-Padiard South Altica 

(Pty ), Ltd. 
P.O. Box 120 
Howard Place, 
Cape Province. 7450 
Pine Park Cemre, Forest Drive, 
PInalanda, 
Cape Province, 7405 
Tel: 53-7955 thru 9 
Telex: 57-0006 
SPAIN 

Hewlett-Packard Espanda, 

S.A. 
Cale Jerez 3 
E-Madrld 16 

Tel:(t)458 26 00(10tines) 
Telex: 23515 hpe 
Hewlett-Packard Espadola S.A. 
Cokinia Mirasierra 
EdUkw Juban 
c/o Costa Brava, 13 
UadrM 34 

Hewlett-Packard Espahda, 

S.A. 

Hianesado 21-23 
E-Barcalona 17 

Tel: 13) 203 6200 (5 lines) 
Telex: 52603 hpbe e 
Hewlell-Pacltard Espanole. 
S.A 

Av Ram6n y Cajal. 1 
EditKio Sevia, planta 9° 
E-SoIHa 5 

Tel: 64 44 54/58 
Hewlell-Packard EspaMa S.A. 
Ediflcn Aibia I 7* B 
E-BUbao 1 

Tel: 23 83 06/23 82 06 
Hewletl-Packard Espanda S.A. 
C/Ramon GordHto 1 

(Enlto.) 
E-Valwicia 10 
Tel: 96-361.13.54/361.13.58 
SRI LANKA 
Metropolitan Agencies LkJ. 
209/9 Union Place 
Colombo 2 
Tel: 35947 

Telex: 1377METR0LTD CE 

SUDAN 

Radnon Trade 

P.O. Box 921 

KItartoum 

Tel: 44048 

Tetex: 375 

SURINAM 

Surlel Radio Holland N.V. 
Grote Hotstr. 3 5 
P.O. Box 155 
Paramaribo 
Tel: 72118, 77880 
SWEDEN 

Hewlett-Packard Sverige AB 

EraghetsvUgen 3, Fack 

S-161 Bromma20 

Tel: (08) 730 05 50 

Telex: 10721 

Cable: MEASUREMENTS 

Stockholm 

Hewlett-Packard Sverige AB 
Frstaisgatan 30 
S-421 32 VUtn 
FrlMinda 

Tel: (031) 49 09 SO 
Telex: 10721 viaBromma 
office 

SWITZERLAND 

Hewlett-Packard (Schwelz) AG 
ZUcherstrasse 20 
P.O. Box 307 
CH-8952 Schllaran- 
Zurich 

Tel: (01) 7305240 
Telex: 53933 hpag ch 
Cable: HPAG CH 
Hewlett-Packaid (Schweiz) AG 
Chlleau Bloc 19 
CH-1219 La Ugnon- 

Ganava 
Tel: (022) 96 03 22 
Telex: 27333 hpag ch 
Cable: HEWPACKA8 Geneva 



SYRIA 

General EteclronK Inc. 
Nuri Basha-Ahnal Ebn Kays 

Street 
P.O. Box 5781 
Oamaacua 
Tel: 33 24 87 
Telex: 11215 ITKAL 
Cable: ELECTROBOR 

DAMASCUS 
Hedk»lonly 
Sawah & Co. 
Place famt 
B P. 2308 



Tel: 16 367-19 697-14 268 

Telex: 1 1304 SATACO SY 

Cable: SAWAH, DAMASCUS 

Slieiman Mai El Mtawl 

P.O. Box 2528 

Mamoui BHar Street, 56-58 

Damaacua 

Tel: 11 46 63 

Telex: 11270 

Cable: HLAL DAMASCUS 

TAIWAN 

Hewlell-Packard Far EasI Ltd. 

Taiwan Branch 

Bank Tower. 51h Fkwr 

205 Tin Hau North Road 

Talpal 

Tel: (02) 751-0404 (15 lines) 
Hewkill-Packard Far EasI LM. 
Taiwan Branch 

68-2, Ching Cheng 3rd. Road 
Kaolialung 

Tel: (07) 242318-Kaohsiung 
AnalytKal Only 
San Kwang kislrumenis Co., 
Lid, 

20 Yung Sui Road 
Tatpal 

Tel: 3615446-9 (4 Nnes) 
Telex: 22894 SANKWANG 

TANZANIA 

MedcalOnly 

kitemathxial Aeradk) (E.A.), Ltd. 
P.O Box 861 
Dar aa Salaam 

Tel: 21251 Ext. 265 
Telex: 41030 

THAILAND 

UNMESA Co. Ltd. 
Ek^HH Research Buiding 
2536 Sukumvit Ave. 
Bangcltak, Bangkok 

Tel: 39-32-387, 39-30-338 

TRINIDAD * 
TOBAGO 

CARTEL 

Caribbean Telecoms Ltd, 

P.O. Box 732 

69 Frederick Street 

Port-of-SpaIn 

Tel: 62-53068 

TUNISIA 

Tunisie Eleclronque 

31 Avenue de la Liberie 

Tunia 

Tel: 280 144 

Corema 

1 ler. Av. de Carthage 

TunIa 

Tel: 253 821 

Telex: 12319 CABAM TN 

TURKEY 

TEKNIM Conipany Ltd. 
Riza Sah Pehlevi 
CaddesiNo. 7 
KavaklMere, Ankara 
Tel: 275800 
Telei: 42155 
Teknim Com., Ltd. 
BarbarosBulvari 55/12 
Besikyas, Istanbul 
Tel; 613 546 
Telex: 23540 
E.M.A. 

Muhendislik KoMM Sirketi 

Medina EklemSokak 4 1/6 

YUksel Caddesi 

Ankara 

Tel: 17 56 22 

YHmaz Ozyurek 

Mil Mudalaa Cad 16/6 

KizHay 

Ankara 

Tel: 25 03 09 - 17 80 26 
Telex: 42576 OZEK TR 

UNITED ARAB 
EMIRATES 

Eirilac LM. (Head Office) 
P.O. Box 1641 
Sbarlah 

Tel: 354121/3 
Telex: 8138 



Emitac Ltd. (Branch Office) 
P.O. Box 2711 
Abu Dhabi 

Tel: 331370/1 

UNITED KINGDOM 

Hewlett-Packard Ltd. 

King Street Lane 

WInnarah, Wokingham 

Berkshire RG11 5AR 

G6-England 

Tel: (0734) 784774 

Telex: 84 71 78/9 

Hewlett-Packard LK). 

Fourier House, 

257-263 High Street 

London Cokiey 

SI. Albans, Herts 

GB-England 

Tel: (0727) 24400 

Telex: 1-8952716 

Hewlett-Packard Lid 

Traialgar House 

Navigatkm Road 

Altrlncham 

Cheshire WA14 1NU 

GB-England 

Tel: (061) 928 6422 

Telex: 668068 

Hewlett-Packard Ltd. 

Lygon Govt 

Hereward Rise 

DudteyRoad 

Halaaowan, 

West MkHands, B62 BSD 

GB-England 

Tel: (021) 501 1221 

Telex: 339105 

Hewlett-Pack»d LM. 

Wedge House 

799, London Road 

Thornton Haath 

Surrey, CR4 6XL 

GB-Engiand 

Tel: 101) 684-0103« 

Telex: 946825 

Hewlett-Packard LM. 

14 Wesley St 

Castlafofd 

YorksWFlO 1AE 

Tel: (0977) 550016 

TWX: 5557335 

Hewlett-Packard Ltd. 

Tradax House 

SL Mary's Wak 

Maldanlwad 

Berkshire, SL6 1ST 

GB-England 

Hewlell-Packard LU, 

MorieyRoad 

StapMHIt 

Bristol, BS16 40T 

GB-England 

Hewlett-Packard LM. 

South Ouaanafarry 

West Lothian, EH30 9TG 

GS-Scolland 

Tel: (031) 331 1188 

Telex: 72682 

UNITED STATES 

ALABAMA 

700 Cenkjry Park South, 

Suite 128 
Bkmlngham 35226 
Tel: (205) 822-6802 

P.O. Box 4207 
8290 Whitesbvg Dr. 
Huntavnia 35802 
Tel: (205) 881-4591 
ARIZONA 
2336 E. Magnolia St. 
Phoanlk 85034 
Tel: (602) 273-8000 
2424 East Aragon Rd. 
Tucson 85706 
Tel: (602) 273-8000 

-ARKANSAS 

MedKai Servce Only 
PO Box 5646 
Brady Statnn 
Uttia Rock 72215 
Tel: (501) 376-1844 

CALIFORNIA 

1579 W. Shaw Ave. 
Fraano 93771 
Tel: (209) 224-0582 
1430 East Orangelhorpe Ave. 
FuNarton 92631 
Tel: (714)870-1000 
5400 Wesi Rosecrans Btvd. 
P.O. 60x92105 
Worid Way Postal Center 
Loa Angataa 90009 
Tel: (213) 970-7500 
Tm: 910-325-6608 



3939 Lankershim Boulevard 
North Hollywood 91604 

Tel: (213) 877-1282 
TWX: 910-499-2671 
3200 HIview Av 
Palo Alto, CA 94304 
Tel: (408) 988-7000 
646 W. North Market Blvd. 
Sacramanto 95834 
Tel: (916) 929-7222 
9606 Aero Drive 
P.O. Box 23333 
San DIago 92123 
Tel: (714) 279-3200 
363 Brookhdow Dr. 
Santa Ana, CA 92705 
Tel: (714) 641-0977 
3003 Scott Boulevard 
SanU Clara 95050 
Tel: (406) 988-7000 
TWX: 910-338-0518 
454 Cariton Court 
So. San Franclaeo 94080 
Tel: (415) 877-0772 
'Tarzana 
Tel: (213) 705-3344 

COLORADO 

5600 OTC Parkway 
Englbwood 80110 
Tel: (303) 771-3455 

CONNECTICUT 

47 Bames Industrial Road 
Bames Park South 
WaHlngford 06492 
Tel: (2031 265-7801 
FLORIDA 
P C Box 24210 
2727 N.W. 62nd Street 
FL Laudardala 33309 
Tel: (305) 973-2600 
4080 Woodcock Drive 0132 
Brownett Buiding 
JackaonvM* 32207 
Tel: 1904) 398-0663 
P C. Box 13910 
6177 Lake Ehnor Dr. 
Orlando 32809 
Tel: (305) 859-2900 
P.O. Box 12826 
Suite 5, BMg. 1 
OHkx Park North 
Panaaeola 32575 
Tel: (904) 476-8422 
110 South Hoover Blvd. 
Sule 120 
Tampa 33809 
Tel: (813) 872-0900 
GEORGIA 
P.O. Box 105005 
450 Interstale North Padiway 
AUanta 30348 
Tel: (404)955-1500 
TtW: 810-766-4890 
Medk^al ServKe Only 
Augusta 30903 
Tel: (404) 736-0592 
P.O. Box 2103 
1172 N.Davis Drive 
Warndr RoMna 31098 
Tel: (912) 922-0449 



HAWAII 

2875 So. King Street 
Honolulu g6826 
Tel: (808) 955-4455 

ILLINOIS 

211 Prospect Rd. 
Bloomlngton 61701 
Tel: (309) 663-0383 
5201 Tolview Dr. 
Rolling HaadowB 
60008 

Tel: (312) 255-9800 
TWX: 910467-2260 
INDIANA 

7X1 North Shadeland Ave. 
tndlanapoHa 46250 
Tel: (317) 842-1000 
TWX: 810-260-1797 
IOWA 

2415 Hetiz Road 

Iowa CKy 52240 

Tel: (319) 351-1020 

KENTUCKY 

10170 Linn Statkm Road 

Suite 525 

Loulavmo 40223 

Tel: (502) 426-0100 

LOUISIANA 

P.O. Box 1449 

3229-39 Wiiams Boulevvd 

Kannor 70062 

Te(: (504)443-6201 



MARYLAND 

7121 Standard Drive 
Pari! way Industrial CeMer 
Hanorar 21076 
Tel: (301) 796-7700 
TWX: 710-862-1943 
2 Choke Cherry Road 
Roekvllla 20650 
Tel: (301) 948-6370 
TWX: 710-628-9684 
MASSACHUSETTS 
32 Hartwelt Ave. 
Lexington 02173 
Tel: (617) 861-8960 
TWX: 710-326-6904 

MtCHIQAN 

23655 Research Drive 
Farmlnaton HNIa 48024 

Tel: (313) 476-6400 
7'J4 West Centre Ave. 
Kalamaioo 49002 
Tel: (616) 323-8382 

MINNESOTA 

2400 N. Prkx Ave. 
SL Paul 55113 
Tel: (612) 636-0700 



322 N. Mart Plaza 
Jackaon 39206 
Tel: (601) 982-9363 
MISSOURI 
11131 Cokirado Ave. 
Kanaaa City 64137 
Tel: (816) 763-8000 
TWX: 910-771-2087 
1024 Executive Pari(way 
SL Loula 63141 
Tel: (314) 878-0200 

NEBRASKA 

MednalOnly 
7101 Mercy Road 
Suite 101 



Tel: (402) 392-0948 

NEVADA 

'LaaVagaa 

Tel: (702) 736-6610 

NEW JERSEY 

Crystal Brook Professkmal 

BulMkig 
Route 35 

Eatontown 07724 
Tel: (201) 542-1384 

W. 120 Cenkry Rd. 
Paramua 07652 
Tel: (201) 265-5000 
TWX: 710-990-4951 
NEW MEXICO 
P.O.Box 11634 
Statton E 

1 1300 Lomas Blvd.. N.E. 
Albuquorquo 87123 
Tel: (505) 292-1330 
TWX: 910-989-1185 
156 Wyatt Drive 
Laa Crucaa 68001 
Tel: (505) 526-2484 
TWX: 910-9983-0550 
NEW YORK 
6 AuhMnation Lane 
Computer Park 
Albany 12205 
Tel: (518)458-1550 
TWX: 710-444-4961 
650 Perinlon HI Oltkx Park 
Fairport 14450 
Tel: (716) 223-9950 
TWX: 510-253-0092 
No. 1 Pennsylvenia Plaza 
55lh Ftoor 

34th Street & 8th Avenue 
Naw York 10001 
Tel: (212) 971-0800 
5858 East Motoy Road 
Syracuaa 13211 
Tel: (315)455-2486 
1 Crossways Padt West 
Woodbury 11797 
Tel: (516) 921-0300 
TWX: 510-221-2183 
Tel: (513)671-7400 

NORTH CAROUNA 

5605 Roanne Way 
Graonaboro 27409 

Te(: (919) 852-1800 
OMO 

Medk:al/Computer Only 
9920 Carver Road 
CkielnnatI 45242 
Tel: (513) 891-9870 
16500 Sprague Road 
Clovaland 44130 
Tel: (216) 243-7300 
TWX: 810-423-9430 



962 Cnjpper Ave. 
CohMibua 43229 
Tel: (614) 436-1041 

330 Progress Rd. 

Dayton 45449 

Tel: (513) 859-8202 

OKLAHOMA 

P.O. Box 32006 

6301 N. Meridan Avenue 

Oklahoma CHy 73112 

Tel: (405) 721-0200 

9920 E. 42nd Street 

Sule 121 

Tulaa 74145 

Tel: (918) 665-3300 

OREGON 

17890 S.W. Lower Boones 

Ferry Road 
Tualatin 97062 
Tel: (503) 620-3350 

PENNSYLVANIA 

1021 Bih Avenue 
King ol Prussia Industrial Park 
King ol Pruaala 19406 
Tel: (2t5) 265-7000 
Tt»X: 510-860-2670 

111 Zeta Drive 
Plttabwgh 15238 
Tel: (412) 782-0400 
SOUTH CAROLINA 
P.O. Box 6442 
6941-0 N. Trenholm Road 
Columbia 29206 
Tel: (803) 782-6493 

TENNESSEE 

8906 Kingston Pike 
KnoivMo 37919 
Tel: (615) 691-2371 
3070 Directors Row 
Directors Squere 
MampMa 36131 
Tel: (901) 346-8370 
-Naahvma 
MedKai Service Only 
Tel: (615) 244-5448 

TEXAS 

4171 North Mesa 
SuleCIIO 
Et Paao 79902 
Tel: (915) 533-3555 
P.O. Box 42816 
10535 Harwm St. 
Houaton 77036 
Tel: (713) 776-6400 
-Lubbock 
Medical SarvkM Only 
Tel: (806) 79g-4472 
P.O. Box 1270 
201 EArapahoRd. 
RiGhardaon 75081 
Tel: (214) 231-6101 
205 Biy MIMhei Road 
San Antonio 78226 
Tel: (512) 434-8241 

UTAH 

2160 South 3270 West Street 
Salt LakoCMy 84119 
Tel: (801) 972-4711 

VIRGINIA 

P.O. Box 9669 

2914 Hungary Spring Road 



FOR U.S. AREAS 
NOT USTED: 
Contact the regnnal office 
nearest you: 

Atlania, Georgia . North 
HoHyMwood.Caikimia. 
RockyWo, Maryland 



Tel: (804) 285-3431 
Computer Systems/Medcal 

Only 

Airport Executive Center 
Suile302 

5700 Thuston Avenue 
Virginia Boach 23455 

Tel: (804)460-2471 

WASHINGTON 

BekCeU Office Pk. 
1203- 114th Ave. S.E. 
Bollavuo 98004 

Tel: (206) 454-3971 
TWX: 910-443 2446 
P.O. Box 4010 
Spokana 99202 
Tel: (509) 535-0864 

-WEST VmOINIA 

MedKal/Analytical Only 
4604 Mac Coikle Ave., S,E. 
Charloaton 25304 
Tel: (304) 925-0492 

WISCONSIN 

150 South Sumy Skipe Road 
Brooktlold 53005 
Tel: (414) 784-8800 



Their complele addresses 
are Hslsd above. 
USSR 

Hewlett-Packard 

Represantathre Office 
USSR 

Pokrovsky BoUevard 

4/17-kw 12 
Moacow 101000 
Tel: 294.20 24 
Telex: 7825 hewpak su 

YUGOSLAVIA 

Iskra Commerce, n.8Cl.o. 
Zastopstvo Hewlett-Packard 
Obicev Venae 26 
YU 1 1000 Baograd 
Tel: 636-955 
Telex: 11530 
Iskra Commerce, n.sol.o. 
Zastopswo Hewtett-Padtard 
Mkk>SKeva 38/VI 
YU-61000 LIubllana 
Tel: 321-674, 315-879 
Telex: 31583 

URUGUAY 

PaUo Fenando SACel. 
Avenda Italia 2877 
Casila de Coneo 370 
MontavMoo 
Tel: 40-3102 
Telex: 702 Pubic Boot! 
Pars Pabk) Ferrando 
VENEZUELA 
Hewlett-Packard de Venezuela 
CA. 

P.O. Box 50933 
Caracas 105 
Los Riaces Norte 
3a Transversal 
EdMkw Segre 
Caracaa 107 
Tel: 239-4133 (20 Iras) 
Telex: 25146 HEWPACX 
ZAMSIA 

R.J. Titiify (Zambia) LM. 
P.O. Box 2792 
Luaaka 

Tel: 73793 

MEDITERRANEAN AND 
MIDDLE EAST 
COUNTRIES NOT 
SHOttm, PLEASE 
CONTACT: 
Hewtstt-Packard S.A. 
Madilerranaan and MkMk East 

Operations 
35, KdokMoni Street 
Plata Kefahriou 
GR KIHsaia-Athona, Greece 
Tel: 8080359/429 
Telex: 21-6588 
Cade: HEWPACKSA Athens 
SOCIALIST 
COUNTRIES NOT 
SHOHVN, PLEASE 
CONTACT: 

Hewlett-Packard Ges.m.b.H. 
Handelskai52 

P.O. Box 7 

A- 1205 VIoMM, Austria 
Tel: (0222) 35 16 21 U 27 
Cable: HEWPAK Vienna 
Telex: 75923 hewpek a 

OTHER AREAS NOT 
LISTED. CONTACT: 
Hewlett-Packard 
htercontinental 
3495 Deer Creek Road 
Palo Alto, CaWomla 94304 
Tel: (415)856-1501 
TWX. 910-373-1267 

Cade: HEWPACK Pato AIM 
Telex: 034-8300, 034-8493 
Hewtelt-Packard S.A. 
7, rue du Bds-du-Lan 

P.O. Box 

CH-1217Meyrin2-Gona>a 

Switzeriand 
Tel: (022) 82 70 00 
Cade: HEWPACKSA Geneva 
Telex: 2 24 86 

-Sonrico Only 

2-15-80 
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